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Introducing ProtoGen+. Visual tools with the most awesome 
workbench ever created for Windows development. 


he future has arrived—a complete 
point-and-click, WYSIWYG 
workbench that lets you create 
dazzling applications without 
writing a line of code. 

Paint vour 

Discover the ease and 
productivity of visual 


development! 


Visually 

develop 

screens 


screens. Design 
a menu and link 
screens togeth¬ 
er. Test the flow 
in a live environ¬ 
ment, and gen¬ 
erate code for 
ANSI C, C++ 
for OWL or MFC 
or Pascal with 
objects. It’s that 
easy. 

And this 

open! ProtoGen+ 
will work with 
your database, 
compiler, 

libraries and extensions. Powerful 
add-on features, like SQLView offer 


Create a menu 
and connect 
screens & dialogs 


Test the applica¬ 
tion's screen (low in 
a live environment 


Instantly generate 
source code in 
Pascal, C or C++ 


-'•I d .1 


workbench access to multiple 
databases to develop client/server and 
xBase applications. Snap-in compo¬ 
nents make ProtoGen+ open to future 
development technologies—whatever 
they may be. 

ProtoGen+ is easy to learn, 
speeds your development cycle and 
protects your investment by generat¬ 
ing C.C++ and Pascal. We guarantee 
you'll 
prototype 
and generate 
exciting 
applications 
faster than 


The most powerful, open set of 
Visual Development Tools ever! 
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Point-and-click to paint 
screens with bitmaps, 
icons, tables, data valida¬ 
tion, custom colors, fonts, 
3D effects, visual tool¬ 
bars, status lines, balloon 
help, MDI and more! 


you ever 

thought 

possible! 


Build win¬ 
dows. forms, 
dialog boxes, 
tool bars 

Output C. 
C++ and 
Pascal with 
Objects 

Create new 
designers! 
Source 
included 
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Menu 

Editor 

Designer 

Code 

ProtoView 

Gener¬ 

Screen 

ator 

Manager 


Custom 

Win- 

Visual 

Control 

Designer 

Library 




Snap-in 


Code 

Generators 




Quickly 
create a 
menu using 
templates 

Data valida¬ 
tion, 3-D 
effects. MDI 
and more 

Rich library 
of visual 
control 
objects 
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iiicense our technolog)' to 
create new code generators 


Fasten your seatbelt 
for ProtoGen+! 


Only 


(list price 
$395) 


Bring your applications to life using the latest 
visual design tools! 


pRtmvMw 

The Visual Development Edge™ 

All products named are trademarks of their 
respective companies. ©1993 ProtoView Development 


$199 

1 - 800 - 231-8588 

Ask for Ext. 60 
In NJ, call (908) 329-8588 
ProtoGen+'s SQLView access to multiple 
databases is available at aa additional price; 
ask about It when you call. 
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No matter what database they throw at you, 
you’ll connect with Q+E ODBC Pack 




Fastball, slider, or change-up. 
dBASE, Paradox, or Oracle. If you want 
to connect, you know you’ve got to 
react fast. 

With the comprehensive lineup 
of over 20 drivers in Q+E ODBC Pack, 
you can. 


Cover all your bases with Q+E. 

Drivers are the critical link between 
your ODBC-compliant applications, 
your network, and your databases. And 
because their quality directly affects the 
performance of your applications, it’s 
vital that you have superior drivers. 

Don’t risk costly errors. Rely on 
Q+E Software for fast, dependable 
drivers. 


Q+E ODBC Pack delivers: 

• Comprehensive coverage: Connect ah 
ODBC-compliant applications to ah 
major SQL and PC DBMS with Q+E 
ODBC Pack. 


• Consistent access: Q+E ODBC Pack 
drivers make all databases look the same 
so you don’t have to change the way you 
work every time you change databases. 

• State-of-the-art technology: Q+E ODBC 
Pack gives you the same database access 
technology used by leading software 
publishers. Plus all drivers are certified 
through Q+E Software’s ODBC Verifi¬ 
cation Suite. 

• High-level implementation: With Q+E 
ODBC Pack you get full SQL, transac¬ 
tion processing, and even network lock¬ 
ing support for non-SQL DBMS. And 
it’s the only set of drivers that sports a 


consistent level of ODBC 
Core, Level 1, and selected Level 2 
functions. 

• One-stop, cross-platform support: No 
other set of ODBC drivers offers the 
range of support available from Q+E 
Software. Support is available for 
Windows; support for OS/2, Windows 
NT, Macintosh, and Solaris will be 
available in early 1994. 

Complete, dependable, and quick, 
Q+E ODBC Pack makes sure your applica¬ 
tions perform—no matter what 
database you have to face. 


Q.+E ODBC Pack provides support for the following databases. 

Oracle, Sybase, Microsoft SQL Server, dBASE, INGRES, Paradox, DB2, SQL/400*, Btrieve, 
DB2/2, INFORMIX, NetWare SQL, Excel ,XLS files, text files, PROGRESS, XDB, SQLBase, 
SQL/DS*, Teradata*, HP ALLBASE, and HP IMAGE/SQL; gateways: Micro Decisionware 
and DB2/2-DDCS/2 (‘requires a gateway). 

Q.+E ODBC Pack drivers link all ODBC-compliant applications, 
including the following, to all major SQL and PC databases. 

Excel 5, Access, Visual Basic, PowerBuilder 3, WinWord 6.0, Lotus 1-2-3 Rel. 4, report 
writers, query and reporting tools, and many others. 


Try Q+E ODBC Pack for 
30 days, risk-free ! 

Make sure your ODBC-com¬ 
pliant applications work tomorrow. 
Put Q+E ODBC Pack on your 
team today! Purchase directly from 
Q+E Software. At only $199 , it’s a 
steal! 

If you are not completely sat¬ 
isfied, return it within 30 days for a 
full refund. No hassles. 

No delays. No errors. 

Call 1-800-876-3101 

Ext. DO 19 
8 am to 8 pm EST 




Q+E 


I ® Database 
Access for 
Client Server 
Computing™ 

mans** 


Q+E Software 

5540 Centerview Drive, Suite 324 • Raleigh, NC 27606 
800-876-3101 ,(919) 859-2220, Fax (919) 859-9334 


• Q+E Software Europe (31) 1022 02022; Fax (31) 1045 63348 • Q+E Software (Deutschland) GmbH, (49) 228 970760; Fax (49) 228 9707610 • Q+E Software (UK) Ltd., (44) 273 489 888; Fax (44) 273 486 224 
©1993 Q+E Software. Q+E is a registered trademark of Q+E Software. Other brand and product names are the property of their respective owners. 
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Printing in Windows NT. 7 

Under the covers, printing works completely differently under Windows NT (and Chicago) 
than under Windows 3.1. Forget about banding and escapes — you want to focus on using 
high-level GDI functions to make spooling fast. This article describes how printing works on 
NT and gives you some C++ code to exercise NT printer “forms. ” 

Paula Tomlinson 

Enumerating Processes in Windows NT. 26 

Windows 3.x programmers who make use of functions in toolhelp.dll will be surprised to find 
that Tool Help does not exist in the Win32 API. You will have to find the equivalent 
functionality in a variety of places, including the system registry. This article shows how to 
use the system registry to enumerate the running processes in Windows NT. 
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Features 


Automatic Tear-Off Menus, Part 2. 41 

Paul’s tearoff. dll makes it easy for you to turn your menus into tear-off menus — menus the 
user can turn into topmost windows for easy access. The conclusion of this article explains 
in detail how tearoff.dll works and provides the remaining code to implement it. 
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Columns 


Practical C++: WUIMAN’s User Interface. 55 
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Windows & DOS 

V 


Programming 

Tools 




Sources 


"Sourcer is the best disassembler 
we Ve ever seen." PC Magazine 


i 


Creates commented source code and list¬ 
ings from binary files. Shows how programs 
work with detailed comments on interrupts, 
subfunctions, I/O functions, and more. Sup¬ 
ports all instructions to 80486 and V20/V30. 

Sourcer provides the best analysis separat¬ 
ing code and data. It automatically deter¬ 
mines data types, uses descriptive labels for 
BIOS and PSP data, and links data items 
across multiple segments. 

New version 5.0 makes most DOS EXE and 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

Top professionals depend on Sourcer for the 
mosNpliable results with the least effort. 


for windows 


"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 
Sal Ricciardi PC Magazine 


Windows Source™ with Sourcer generates 
detailed listings of Windows EXEs, DLLs, 
SYSs, VxDs, device drivers & OS/2 NE files. 
Labels, by name, export & import function 
calls, API calls like "GetFreeSpace" and more. 

See the many undocumented Windows 
functions used by professionals to perform 
tricks that are otherwise impossible. 

Comes complete with extra utilities for 
resource extraction and import analysis. 
Uses CodeView symbols for improved clarity. 


BIOS Source 


for PS/2, AT, XT, PC and Clones 

The BIOS Pre-Processor ™ with Sourcer 
creates commented listings for any BIOS 
ROM in your PC. Understand how your 
specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Identifies 
multiple interrupt branches with special 
labeling like "int_10_video.’ Fully automatic. 

Sourcer -Commenting Disassembler $129.95 
Sourcer w/BIOS -(save $10) 169.95 

ASMtool 486 -Automatic flowcharter 199.95 
ASM Checker -Finds source code bugs 99.95 
Windows Source -requires Sourcer 129.95 
Windows Source & Sourcer-(save $30) 229.90 

Shipping: USA $6; Canada/Mexico $10; Other $18. CA 
residents add sales tax. © 1993 VISA/MasterCard/COD 

30-DAY MONEY-BACK GUARANTEE 

1-800-648-8266 order desk 

V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 275-WD 
San Jose, CA 95129 FAX 408-296-4441 
408-296-4224 





From 

the Editor 


Welcome to our Windows NT theme issue. As I mentioned last 
month, I'm not one of those people who think NT has flopped. It 
seems to be put-putting along about right, and I expect dropping hard¬ 
ware prices and (especially) the advent of multi-processor machines will 
start to move significant numbers of customers to NT within one to 
two years. Symmetric multiprocessing (real SMP, not OS/2's version), 
portability, and the high-end O/S features will pay off in the end for 
NT. 

However, I do have some qualms about the future of NT. It doesn't 
bother me that it is only selling in modest volumes right now. What 
does bother me is that it is not as thoroughly compatible with the 
Windows 3.1 API as I first thought, and yet neither is it as free of 16-bit 
vestiges as I had first imagined. More important, the rumor mill says 
that the folks building Chicago (the version to follow Windows 3.1) 
have a bad craving to tinker with the Win32 API that NT defines. For 
the first time, Microsoft will have two major operating systems to keep 
in sync - I wonder how well they will manage it. The "Windows every¬ 
where' philosophy only works to the degree that it is the same Win¬ 
dows API everywhere and at roughly the same time. 

The bottom line for developers is the same as always. The future is 
unpredictable: the best you can do is defend yourself against it by 
keeping your code as portable as possible and isolating the code that 
accesses system services as well as you can. That keeps getting harder 
as applications compete more on user interface features and less on 
more abstract computing features. □ 


Ron Burk 


Editor 

CIS: 71302,2566 ; Internet: ronb@rdpub.com (“... !uunet!rdpub!ronb”) 
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AAA 

Develop 

Windows Applications 
Quickly and Easily 


Phase3 Has Everything You Need 


Visual Development 

The Phase3 visual development environment 
provides a comprehensive suite of tools for 
screen creation. All standard Windows 
screen objects - push buttons, radio buttons, 
dialog boxes, etc. - are selectable from icon 
bars and are dynamically placed and sized 
on the screen as appropriate for the 
application. Standard Windows APIs are 
available from list boxes and are supported 
with on-line documentation. 


Phase3 Database 

Phase3 includes a relationally complete 
database supplied as a Windows DLL. The 
database supports complex data relation¬ 
ships and access and data manipulation by 
any language through a comprehensive 
suite of supplied database routines. 
Database integrity is enhanced with 
rollback recovery and transaction control. 
The Phase3 data dictionary simplifies data 
model definition and maintenance. 


Query and Reporting 

The Report Writer includes standard 
features like flexible headers, footers, free 
text, calculated fields, sort group sections 
and breaks, and subtotals. Reports can also 
include bitmaps of drawings and photo¬ 
graphic images. Queries are executed with 
the Database Browser which also allows 
data entry and manipulation. Railway 
diagrams assist in query creation, prompt¬ 
ing the user for appropriate selections and 
eliminating syntactical errors. 



Royalty-Free Applications 

Windows is a trademark of Microsoft Corporation. Turbo Pascal 
for Windows and Borland Pascal 7.0 are trademarks of Borland 
International, Inc. All other trademarks or service marks are 
recognized as the property of their respective owners. 


Lower CASE, E-R Modeling 

Phase3 automates logical data model design 
with Entity-Relationship modeling. After a 
user describes entity relationships graphi¬ 
cally and enters field descriptions, Phase3 
generates the physical database based on an 
analysis of the entity relationships. Phase3 
automatically includes foreign keys in 
appropriate tables and restructures the 
database as requirements change. Phase3 
suggests appropriate referential integrity 
constraints to be enforced at runtime. 


Hierarchy Chart 

Phase3 maintains a graphical map of an entire 
application. The Hierarchy Chart includes all 
windows, dialogs, reports, and code routines. 
To access the underlying C or Pascal source 
code, simply point-and-click on any node. 
Phase3 generated source is easily accessed 
and extended with user written routines. User 
code is preserved even if an application is 
regenerated. The Hierarchy Chart and E-R 
Diagram provide instant core documentation 
for an application. 


Help Generator 

The Phase3 Help Generator allows the easy 
creation of a complete Windows application 
help subsystem including context sensitive 
on-line help. The Help Generator includes its 
own text editor that gives complete control 
over the content, appearance, and branching 
logic through highlighted trigger text. Phase3 
generates a Windows compatible file with an 
“.HLP” extension that is then accessible 
from within the Phase3 created application. 
No other external tools are required. 


. a thoroughly remarkable product... 


very impressive 


Jeff Duntemann 

PC Techniques 


A 


“I was very impressed with Phase3, and using it 
made me wish I had learned Windows programming 
with a tool like this. Now that I know what it has to 
offer, I'll probably use it to build the frame for most 
of my programs.” 

L. John Ribar 

Windows Tech Journal 

▲ ▲ A 

“Phase3 hides the complexity of Windows program¬ 
ming but still allows an experienced programmer to 
drill down and extend generated C or Pascal source 
code, providing ultimate control.” 

Randy Goodhew 

Computer Software Columnist 


“Phase3 takes an intuitive, innovative approach to 
developing Windows applications. It’s a pleasure to 
work with and has greatly boosted our productivity. 
One of the most important issues for us is that their 
technical support is excellent.” 

Reuben Halevi 

ISoft D&M 

AAA 

“It's easy to put together an application with Phase3 
- everything’s integrated. And the Phase3 database 
is terrific. It's closer to true relational than anything 
we've found.” 

Michael Erickson 

Prism Business Solutions 


Order Now 

800 - 851-5650 

Or Call for Free Demo Disk 
Fax(805)641-9083 


CALL NOW FOR COMPETITIVE UPGRADE PRICING 
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GSS*CGI Graphic Tools now from EMATEK 

Soon available on all platforms: 

MS-Windows, Windows NT, OS/2 PM, Solaris, UNIX on PCs and workstations. 
Your application written with the GSS*CGI Graphic Tools 
will be portable to all platforms. 



GSS*GKS 


s 


Graphics Development Toolkit enables you to develop 
applications in a device and system independent way 
through the help of device-specific drivers based on the 
ISO CGI Standard. GSS'GDT consists of a library with 
more than 160 callable C and FORTRAN functions and is 
compatible with the graphics development tools from IBM 
and SCO. 

GSS'GDT is available for DOS, MS-Windows, Windows 
NT, OS/2 PM, Interactive Unix, Onsite Unix SVR 4.2 and 
Solaris. 

Versions for SCO Unix, UnixWare and HP Workstations will 
be soon available. 


raphical Kernel System is a C and FORTRAN function 
library that enables you to develop portable graphic 
applications which include e.g. user interaction, coordinate 
transformation and object segmentation, based on the ISO 
GKS Standard. GSS*GKS, which is installed in large 
quantities on the DOS platform and has been proved 
successful for years, is now available for the graphical user 
interfaces and therefore offers the software developer a 
smooth transition to the new windowing systems. 
GSS*GKS is available for DOS, MS-Windows, Windows 
NT, OS/2 PM, Interactive Unix, Onsite Unix SVR 4.2 and 
Solaris. 

Versions for SCO Unix, UnixWare and HP Workstations 
will be soon available. 






GSS*GCT 

^ — 1 

= 

GSS*EVT 

- 





EMATEK Vectorfont Toolkit enables you to integrate 
vectorfonts into your application. Supported font formats 
are PCL5, PostScript Type 1, TrueType and Bitstream 
Speedo. GSS*EVT offers a variety of additional elements 
and attribute functions like character height and gap, 
rotation and italicize angle, fill area pattern and outline- 
width, shadow, background boxes, leader and underlining 
as well as sub- and superscripting for scientific purposes. 
GSS*EVT is an add-on for GSS'GDT, GSS'GKS, 
MS-Windows SDK and will be ported to all popular 
graphical user interfaces. 


Graphics Charts Toolkit provides you with high-level 
functions to integrate presentation graphics into your 
application. With only a few calls you can output pie, bar, 
line, step, schedule or text diagrams on a display or 
printer. Each part of the chart can be altered through the 
related attribute functions. GSS'GCT is an add-on for 
GSS'GDT and GSS'GKS and will be ported to all popular 
graphical user interfaces, thus providing portable presen¬ 
tation graphic capabilities for all supported systems. 
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Printing in Windows NT 


Paula Tomlinson 


Microsoft redesigned the printing subsystem for Windows NT with three pri¬ 
mary goals in mind: decreased return-to-application time, improved WYSIWYG 
output, and enhanced remote printing support. 

Return-to-application time refers to the amount of time the application is 
tied up with the job of printing, as opposed to how much time the printing 
actually takes. The assumption is that users care more about getting back to 
work in their applications than about the overall print time. To accommodate 
this, the print subsystem itself has been redesigned to perform high-level spool¬ 
ing, or journaling, of device calls. Journaling automatically gives Win32 applica¬ 
tions a much faster return-to-application time, since the printer driver now does 
its rendering in the background during unspooling. 

WYSIWYG, or what-you-see-is-what-you-get, for Windows 3.1 has generally 
represented the desire to match printed output as closely as possible to the 
screen output. Win32 on Windows NT takes this a step further: the goal is not 
just WYSIWYG between a specific application's output on a given screen and a 
given printer, but consistency across applications and across output devices and 
even across networks. 

Windows NT supports true remote printing. You can use the Print Manager 
to browse through remote printers and install and configure printer drivers re¬ 
motely. In fact, if you are printing to a remote printer, you needn't even install 
the printer driver (or any associated soft fonts) locally. Windows NT also sup¬ 
ports print pooling, which allows you to set up one logical (named) printer that 
offloads print jobs to a pool of printers. This remote printing architecture in¬ 
creases network printing performance and enhances WYSIWYG output across 
the network. 

Inside the Windows NT Print Subsystem 

I'll begin by describing the components of the Windows NT print subsystem 
(see Figure 1). You may notice a subtle change in terminology with respect to 
GDI (graphics device interface). GDI is usually referred to as a component of the 
Windows operating environment. In the context of the print subsystem, this 
component is referred to as the graphics engine and GDI represents the inter¬ 
face between the application and the graphics engine. 


Paula Tomlinson received an Electrical Engineering degree from Colorado State Univer¬ 
sity. For the past six years she has developed various DOS, Windows, and Windows 
NT-based drivers and commercial applications for the HP ScanJet scanners, the HP 
LaserJet Fax, and the HP DeskJet printers. She is currently working on a book tenta¬ 
tively titled Writing Device Drivers for Windows NT. The opinions expressed in this arti¬ 
cle are hers alone and do not necessarily reflect the opinions of Hewlett-Packard. Send 
questions or correspondence to Paula via internet as paulat@vcd.hp.com. 
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Figure 1 Diagram of printer architecture 



When a Win32 application calls CreateDCO to create a 
printer device context (DC), the request is routed to the 
print spooler. The spooler is a Win32 executable module. 
It is loaded when Windows NT starts up and continues to 
run until Windows NT is shutdown. The Print Manager 
provides the user interface for accessing the spooler, but 
the spooler will still continue to run if the Print Manager is 
closed. In a network, a spooler runs on each client/work¬ 
station. The spooler loads the printer driver specified in 
the CreateDCO call, and then determines from the driver 
which data type to use for saving print jobs targeted for 
that printer. The supported data types are Journal (default) 
and Raw. These data types will be discussed in more de¬ 
tail later. 

DDI (device driver interface) is the interface that the 
graphics engine uses to communicate with printer drivers. 
If the printer driver is located on a remote machine (the 
print server), then the printer driver will be copied from 
the server and loaded into the client's memory. If an ap¬ 
plication calls query functions such as GetDeviceCapsO or 
GetTextExtentO to the printer DC, the graphics engine con¬ 
verts these calls into DDI calls to the printer driver. The 
printer driver returns the corresponding information to the 
graphics engine, which in turns passes the information 
back to the calling application. When an application per¬ 
forms graphics output such as TextOutO or BitBltO to the 
printer DC, the graphics engine again translates those calls 
into DDI calls using information (such as resolution and 
supported fonts) from the printer driver. But instead of being 
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rendered by the printer driver now, the DDI calls are 
saved in the data type specified by the spooler. For the 
Journal data type, the graphics engine passes the DDI 
calls to the spooler, which records them in a Journal file. 
For the Raw data type, the graphics engine calls the 
printer driver to render the DDI calls into device-specific, 
low-level commands and passes the Raw data to the 
spooler. 

It's the spooler's job to create and maintain a list of 
print jobs for each printer and to schedule those jobs for 
printing. Once the spooler determines that a job is ready 
to be printed, it passes the spooled document to the print 
processor. The default print processor for Windows NT in¬ 
terprets both Journal and Raw data types, but custom 
print processors that support addi¬ 
tional data types or perform addi¬ 
tional processing of the Raw or Jour¬ 
nal spool files can be added to the 
print subsystem. If the data type is 
Raw, it is already in a format the 
printer can accept, so the print proc¬ 
essor simply returns the document to 
the spooler. If the data type is Jour¬ 
nal, the print processor passes the 
journal file to the graphics engine, 
which passes it on to the printer 
driver for rendering into device-spe¬ 
cific data. The printer driver converts 
the journal file into raw device data 
and passes it back to the spooler. 

At this point the spooler has raw 
device data that is ready to be 
printed. If the target printer is a re¬ 
mote printer on the print server, the 
client spooler passes the file, via a 
router and print provider, to the serv¬ 
er's spooler. The router and print 
provider isolate any network-specific 
protocols and transport layers from 
the other components in the print 
subsystem. The spooler then passes 
the file to the appropriate print moni¬ 
tor for the target port. The print 
monitor provides a common inter¬ 
face to the spooler, hiding the specif¬ 
ics of the port I/O and the NT I/O 
subsystem. The print monitor gener¬ 
ally handles any device-specific soft¬ 
ware protocols, while a kernel-mode 
port driver handles the port-specific 
hardware protocol. When the printer 
has finished printing the document, 
the print monitor displays a message 
in the Print Manager indicating the 
print job is complete. 

Even jobs printed from DOS appli¬ 
cations or Windows 3.x applications 
get redirected to the spooler in Win¬ 
dows NT. 


New Win32 Print Routines 

Flow does the redesigned Windows NT print architec¬ 
ture impact Win32 applications? First, if you aren't already 
using the common print dialogs, now is the time to make 
the switch. The common print dialogs are by far the easi¬ 
est way to acquire a handle to a printer device context. 
The Foundation Classes also provide a CPrintDialog and 
CPrintlnfo class for this purpose. Except for a few very mi¬ 
nor user interface changes and a few additional options, 
the Win32 common print dialogs, contained in 
comdlg32.dll, are identical to those in Windows 3.x. If you 
don't want to use the common dialogs, you should at the 
very least replace any code that parses the UIN. INI file for 
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Typical programmer before using Utah, 
a revolutionary GUI development breakthrough 



3 


I frequently attended TRS-80 user group meetings. 

I figured OLE was something people yelled at charging bulls. 
I believed multimedia was TV and radio on at the same time. 
I thought Visual Basic was the latest in object technology. 


\M 
















Same programmer after using Utah, the fast, 
flexible GUI development technology from ViewSoft 


jj 

L 


Utah™ for Windows. It’s new technology, not just a new tool — because it lets you create 
complex GUI applications without writing any interface code. Moreover, Utah does it all without 
sacrificing the flexibility and extensibility necessary to build customized human interfaces. 



"Now I have time to 
shave and shower." 

3 Thanks to Utah, using 
events to tie interfaces to 
applications is a thing of the 
past. Kind of like dinosaurs. 

You see, Utah does the 
binding automatically. 

Repeat, automatically. 

Imagine the time savings, 
then “bind” that to your 
bottom line. 

E3 Now you can leave the 
GUI “muck” behind and 
focus entirely on business 
requirements — all because 
ViewSoft’s radical Semantic 
Interface Technology allows 
you to generate interfaces 
of any design with a frac¬ 
tion of the difficulty it takes 
using today’s best conven¬ 
tional tools. Little wonder it’s called a revolution. 

"My job's really fun again. And so am I." 

13 Simply define a C++ class, then choose and arrange graphi¬ 
cal components that represent member fields or functions, 
and the presentation is automatically (there’s that word 
again) bound at run time to the underlying code — with 
execution speed comparable to hand-coded connections. 

"The boss is thrilled. So is my spouse." 

[3 Utah lets you completely replace your entire interface 


without affecting your code 
in any way. Not only will 
you have no interface code, 
you’ll have dramatically 
fewer lines of application 
code to write and maintain. 
This, combined with the 
huge suite of graphical 
components, allows you to 
try things you would never 
otherwise attempt. 

"I feel new and 
improved!" 

3 How else does Utah 
save your time and sanity 
(if it’s not too late)? It allows 
you to create as many views 
of a class as you’d like, while 
view embedding and view 
inheritance allow complex 
presentations of classes to 
be reused in many places. 

"You'll see an amazing difference in just 30 days." 

13 Why live in the past when you can 
put your fingers on the future? Utah 
will convince you the very moment you 
give it a try — which, as you see below, 
is very easy and painless to do. Call now. 

Money-back guarantee and free 30-day 
evaluation copy, complete with tutorial. 

Call 1-800-ViewSoft today. 




ViewSoft, Inc. 
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Figur© 2 List of Win32 print routines 

Document Print Control 

Functions 

AbortDoc 

Terminates a print job. replaces ABORTDOC escape 

AbortProc 

Application defined callback, processes canceled print job 

AdvancedDocumentProperties 

Configures printer advanced settings 

DeviceCapabilIties 

Returns device-driver capabilities 

DeviceCapabilitiesEx 

Not implemented; use DeviceCapabilities 

DocumentProperties 

Configures printer settings 

Escape 

Allows access to a device capability 

EndDoc 

Ends a print job, replaces ENDDOC escape 

EndPage 

Narks end of page, replaces NEWFRAME escape 

ExtEscape 

Allows access to private device capability 

SetAbortProc 

Sets the abort function for a print job, replaces SETABORTPROC escape 

StartDoc 

Starts a print job, replaces STARTDOC escape 

StartPage 

Marks start of page, replaces NEWFRAME/STARTDOC escapes 
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printer information with calls to the 
new Win32 routines, such as Enum- 
PrintersO and OpenPrinterO. You 
should also replace code that still 
uses LoadLibraryO and GetProcAd- 
dressO to call the printer driver's 
ExtDeviceModeO routine directly with 
calls to DocumentPropertiesO. In fact, 
don't even assume that the printer 
driver is located locally on your ma¬ 
chine. If you need to access it directly 
for any reason, use GetPrinterDirec¬ 
tory (). The Win32 API provides a 
whole new set of routines for enu¬ 
meration, information retrieval, instal¬ 
lation, and configuration of the com¬ 
ponents of the NT print subsystem (see 
Figure 2). You can also view printer 
property information in the Regstry 
key HKEY_LOCAL_MACHINE\SYS- 
TEM\CurrentControlSet\Control\Print. 

You should also consider replacing 
any remaining calls to Escape() with the 
corresponding print job control routines 
(see Figure 2). In Windows 3.0, applica¬ 
tions controlled the flow of print jobs 
by using EscapeO with a whole host of 
escape codes (64 to be exact!). Win¬ 
dows 3.1 introduced a new set of rou¬ 
tines to serve as an alternative to these 
job control escape codes. In particular, 
the introduction of specific routines for 
StartPageO and EndPageO eliminated the 
ambiguity between page breaks that 
resulted from using the NEWFRAME es¬ 
cape sequence (NEWFRAME ended the 
current page and started the next). In 
Windows 3.1 it is still necessary to use 
several of the escape codes (to acquire 
information about the printer and 
physical page, and to perform banding 
by the application), but in Windows NT 
there is little need for them. Of the 64 
escape codes, only two are truly sup¬ 
ported in Windows NT (QUERYESCSUP- 
PORT and PASSTHROUGH): nine others 
are supported for compatibility with 
Windows 3.x (ABORTDOC, ENDDOC, 
GETPHYSPAGESIZE, GETPRINTINGOFP 
SET, GETSCALINGFACTOR, NEWFRAME, 
NEXTBAND, SETABORTPROC, and 
STARTDOC). 

Background Banding 

Printers that cannot image a full 
page of output all at once use a tech¬ 
nique called banding. In Windows 
3.x, the graphics engine supported 
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banding transparently by saving out¬ 
put commands to a metafile. It then 
played the metafile back once for 
each band, clipping the output to just 
the current band. Replaying the en¬ 
tire metafile multiple times was so 
painfully slow that Windows 3.x ap¬ 
plications often performed banding 
themselves by calling EscapeO with 
the BANDINFO and NEXTBAND es¬ 
cape codes. With the information re¬ 
turned, applications could limit out¬ 
put to only one band at a time. To 
find out whether a printer is a band¬ 
ing printer, applications can call Get- 
DeviceCapsO with the RASTERCAPS index 
and check the return value for the 
RC_BANDING bit. 

In a journaling print system, if 
banding support is required, the 
graphics engine takes care of it when 
the journal file is unspooled, and 
thus completely out of the hands of 
the application. Consequently, even 
though Windows NT supports the 
NEXTBAND and BANDINFO escapes 
for compatibility, removing applica¬ 
tion-level banding code will minimize 
return-to-application time. You can 


Figure 2 continued 

Spooler and Print Job Functions 

AddJob 

Starts a print job 

AbortPrinter 

Deletes printer spool file 

EndDocPrinter 

Ends a print job 

EndPagePrinter 

End a printer page 

EnumJobs 

Gets print job information 

GetJob 

Get print job information 

PrinterMessageBox 

Displays printing job error message 

ScheduleJob 

Schedules an added job for printing 

SetJob 

Sets print job information 

StartDocPrinter 

Starts print lob 

StartPagePrinter 

Starts a printer page 

Printer Form Functions 

AddForm 

Adds a printer form 

DeleteForm 

Removes printer form 

EnumForms 

Enumerates supported printer forms 

GetForm 

Gets printer form information 

SetForm 

Sets printer form information 

Monitor and Port Functions 

AddMonitor 

Adds a printer monitor 

AddPort 

Adds a printer port 

ConfigurePort 

Configures printer port 

DeleteMonitor 

Removes a printer monitor 

DeletePort 

Deletes a printer port 

EnumMonitors 

Enumerates available monitors 

EnwnPorts 

Enumerates available printer ports 

Print Processor Functions 

AddPrintProcessor 

Copies a print processor to a server 

DeletePrintProcessor 

Removes printer processor 

EnumPrintProcessors 

Enumerates installed print processors 

GetPrintProcessorDirectory 

Gets path for print processor 
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Figure 2 continued 

Print Provider Functions 

AddPrintProvIder 

Adds a printer providor 

DeletePrintProvIder 

Removes printer providor 

Printer Driver Functions 

AddPrinterDrlver 

Copies a printer driver to a print server 

DeletePrinterDriver 

Removes printer driver 

EnumPrinterDrivers 

Enumerates installed printer drivers 

GetPrinterOriver 

Gets printer driver Information 

GetPrinterDriverDIrectory 

Gets path for printer driver 

Printer Functions 

AddPrinter 

Creates a printer on a printer server 

AddPrinterConnection 

Adds connection to printer for current user 

ClosePrinter 

Closes an open printer 

ConnectToPrinterDlg 

Displays dialog for browsing and connecting to network printers 

DeletePrinter 

Deletes a printer on a printer server 

DeletePrinterConnection 

Deletes a connection to a printer 

EnumPrinters 

Enumerates available printers 

GetPrinter 

Gets printer information 

GetPrinterData 

Gets printer configuration information 

OpenPrinter 

Gets handle for specified printer 

PrinterProperties 

Modifies printer properties 

ReadPrinter 

Reads printer data 

ResetPrinter 

Sets printer data type and device mode values 

SetPrinter 

Sets printer information 

SetPrinterData 

Sets printer configuration information 

WaitForPrinterChange 

Waits for change(s) on a printer or print server 

WritePrinter 

Writes data to printer 

Print Messages 

WMJPOOLERSTATUS 

Sent whenever a print job is added or removed 


further optimize performance by us¬ 
ing fewer, more complex primitives 
(for example, Bezier curves instead of 
line segments), since it takes less 
time to record the smaller set of DDI 
calls to the journal file. If the printer 
driver or printer cannot accept the 
more complex primitives, the graph¬ 
ics engine will break them down (in 
the background during unspooling) 
into simpler primitives. 

No More Brute Functions 

The general principles for WYSI¬ 
WYG display that govern Windows 
B.x applications (such as creating 
screen fonts to match the printers' 
fonts) still apply for Win32 applica¬ 
tions. However, the new graphics en¬ 
gine plays a much bigger role in sup¬ 
porting cross-application and cross¬ 
device output consistency and so 
overcomes some of the problems in¬ 
herent with Windows 3.x. For in¬ 
stance, in Windows 3.x there was a 
gray area between where the graph¬ 
ics engine left off and where the dis¬ 
play and printer drivers began (you 
might have noticed in Windows 3.x 
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that changing display drivers often caused printed output 
to look different). 

The brute functions are the culprit in this perplexing 
dependency of printer drivers on display drivers. The brute 
functions consist of a series of helper routines provided by 
the Windows 3.x graphics engine to assist printer drivers 
with many operations involving memory bitmaps. Banding 
printer drivers in particular use the brute routines, since 
they typically image their output to a memory bitmap be¬ 
fore dumping that bitmap to the printer. Unfortunately, 
the brute functions operate by calling corresponding rou¬ 
tines in the display driver, and there is no guarantee that 
all display drivers will implement those functions in ex¬ 
actly the same way. Windows NT solves this problem by 
providing services for display drivers and printer drivers 
within the graphics engine itself. Locating these services in 
the graphics engine makes them truly common services 
and thus helps to ensure more consistent output across 
devices. 

Graphics Engine-Supported Halftoning 

Another feature of the new graphics engine is sophisti¬ 
cated internal support for halftoning. The fact that differ¬ 
ent applications halftone grayscale and color images dif¬ 
ferently has been a significant problem in Windows 3.x. 
Worse yet, applications and printer drivers often fight over 
who should perform the halftoning, if the application half¬ 
tones the image before printing and the image somehow 
gets scaled in the printing process, the printed image dis¬ 
plays ugly interference patterns. 
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Listing 1 cprint.h 


Listing 2 cprint.cpp 

II CPRINT.H Windows NT. MS Visual C/C++ (32-bit) 1.1 

//include <windows.h> 

//define IDCJJOCTITLE 9000 

class CPrint { 
public: 

CPrinttHWND hWindow. LPTSTR lpDocName = "(Untitled)"): 
virtual -CPrintO: 

HDC PrintDialog(void); 

DWORD PrinterSetupDi al og(void) ; 

DWORD DocumentStart(HINSTANCE hlnst); 

DWORD PageStart(void); 

DWORD PageEnd(void); 

DWORD DocumentAbort(void); 

DWORD DocumentEnd(void) : 

char szDriver[32]. szDevice[32]. sz0utput[32]; 

DWORD lastError: 
private: 

// prevent copy by declaring without defining 

CPrint(const CPrintA): 

const CPrintA operator=(const CPrint&); 

HDC hdcPr; 

HWND hWnd; 

DOCINFO doclnfo; 

PRINTDLG printDlg; 

): //CPrint 
/* End of File */ 


II CPRINT.CPP Windows NT, MS Visual C/C++ (32-bit) 1.1 
i/include <windows.h> 

^include ''cprint.h” 

LRESULT CALLBACK AbortDlg(HWND. UINT, WPARAM, LPARAM); 

BOOL CALLBACK AbortProc(HDC, int); 
char lpbocT1tle[128]; 

BOOL bAbort = FALSE: 

HWND hDlgAbort = 0; 

/**.**/ 

CPrint::CPrint(HWND hWindow, LPTSTR lpDocName) { 
hdcPr = NULL; 
lastError = NULL; 

szDriver[0] » szDevice[0] = szOutput[0] = ’\0'; 

1strepy ( 1pDocTitle. lpDocName): 
doclnfo.cbSize = sizeof(DOCINFO); 
doclnfo.1pszDocName = lpDocTitle: 
doclnfo.IpszOutput » 0; 

memsetdvoid *)&printDlg, 0. sizeoftPRINTDLG)): 
printDlg.IStructSize = sizeof(PRINTDLG); 
printDlg.hwndOwner = hWnd = hWindow; 

) // CPrint 

/**. Irk/ 

CPrint::-CPrint( ) { if (hdcPr) DeleteDC ( hdcPr ) : ) // -CPrint 

/** . **/ 

HDC CPrint::PrintDialog(vo1d) { 

LPDEVNAMES pNames; 


Disk space issues aside, you should consider using 
grayscale and color images within your Win32 applica¬ 
tions and letting the graphics engine (with the help of the 
printer driver) take care of halftoning to a particular de¬ 


vice. Users can adjust some of the properties of halftoning 
from the Print Manager; an application can do so by using 
CreateHalftonePaletteO, SelectPaletteO, RealizePaletteO, 
and SetColorAdjustmentO. 


Want to get the source code for 
the Borland 3D Chart Control? 


ToolsKan 


Visual Basic Toolkit $99 


For SDK & Visual Basic 
3D Chart 

- Over 30 of 2D & 3D chart styles 

- Rotation & scrolling 

- Supports printing & clipboard 

Toolbox 

- Creates buttons from bitmaps 
or text 

- Supports scrolling 

- 3D buttons w/ color customization 

- Single/multiple/no-state button 
groups 

Ribbon 

- 3D items with color customization 

- Supports combobox, text, & buttons 

Field Validation 

- Validates date, time, number fields 
& "PIC" statements 


Meter 

- Creates vertical, horizontal. & 
circular gauges with choice of 
needle or color bar as indicators 

- Linear & logarithmic scales 

Table 

- Column & row split windows 

- Multiple row & column selections 

- Check boxes/radio buttons/bitmaps/ 
editable/combobox column 

- Input validation 

- Color customization 

Status Bar 

- Auto scrolled text 

- Stretchable field width 

- Colored progress bar 

- Show date, time, & key states 


Windows SDK Bundle $199 

$199 SDK DLL Bundle includes Table, Toolbox, 
Status Bar, Ribbon, Field Validation & Meter. 



Consulting & 

Contract Programming Available 


Free Demo from BBS. 

No Royalties. 30-day MBG. 
Optional with source code. 


Tel: (408) 263-9881 
Fax: (408) 263-9883 
BBS: (408) 263-0892 


Kansmen Corporation 
P.O. Box 360070 
Milpitas, California 95036 
USA 



Elan License Manager™ 

Enterprise-Wide Software Licensing 
Now available for Windows ® and Windows NT®! 

Elan offers developers the next generation 
in software licensing. This problem free 
all software solution installs easily to 
protect your applications. 

• Eliminates unauthorized use. 

• Sets flexible time limits for demo 
copies. 

• Offers the kind of user-based licensing 
capability that users are demanding 
today! 

Available for Windows®. Windows NT®, 

Unix® and VMS' - applications. 

Call us today al: 1-800-536-ELAN 
Elan Computer Group. Inc. 

8X8 Villa St., Suite #300 Mt. View. CA 94041 
415-964-2200 FAX 415-964-8588 

filan License Manager is a trademark of Elan Computer Group. Inc 
All other trademarks are property of the respective owners. 
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This is your 
career. 


If you’re a desktop developer hungry for new 
opportunities, Powersoft is serving up something 
you’re sure to like. A $249* desktop version of our 
award winning PowerBuilder™ the application develop¬ 
ment software that’s helped thousands of companies 
make the transition to client/server computing. 

With PowerBuilder Desktop you get many of 
the same ingredients in our Enterprise edition in 
portions that make sense for the desktop-class 


databases already residing on your network. 

For starters, you can create your own client/server 
applications using a common object technology. 
A technology that lets your programs, as well as your 
programming know-how, be scaled to run against any 
database from .DBF to DB2.® 

With PowerBuilder Desktop you also get to take 
advantage of hundreds of built-in functions to access 
and manipulate data, perform calculations, and 



This is your career on 
new PowerBuilder Desktop. 
Any questions? 



communicate with other applications. 
Something you’ll appreciate very quickly 
once you realize how much time it saves. 

Of course you’ll want more on 
your plate than that. So there’s also 
our “SQL Smart” DataWindow™ to build applications 
without coding SQL. A built-in data dictionary to 
increase productivity and ensure standards. And the full 
32-bit relational power of theWATCOM™ SQL database. 


Introductory 
Price: $249''' 


If we still haven’t whet your appetite, consider 
our one-day comprehensive client/server training class 
for only $399 that includes your personal copy of 
new PowerBuilder Desktop. Just call Powersoft at 
1-800-946-3500 for dates and a location near you. Or if 
you want to get your career cooking even sooner, call 
your corporate reseller, stop by CompUSA, or call 

Powersoft at 1-800-642-1421 today. Powersoft 

Building on the power of people. 


" Introductory price; suggested retail price: $695. Powersoft Corporation, 70 Blanchard Road, Burlington, MA 01803 
Powersoft Europe, Thames House, 1 Bell Street, Maidenhead, Berkshire, SL6 1BU, United Kingdom 
All trademarks and registered trademarks are property of their respective owners. Prices listed do not include sales tax, shipping and handling. 30-day money back guarantee. 
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Listing 2 continued 


printDlg.Flags = PO_RETURNDC; 
if (PrintDlg(&printDl g)) { 
hdcPr = printDlg.hDC; 

pNames = (LPDEVNAMES)Gl obalLockiprintDl g.hDevNames); 
IstrcpytszDriver, (LPSTR)pNames + pNames->wDriverOffset); 
IstrcpylszDevice, (LPSTR)pNames + pNames->wDeviceOffset); 

1strcpy(szOutput, (LPSTR)pNames + pNames->wOutputOffset); 

G1obalUni ock(printDlg.hDevNames); 

} else hdcPr = FALSE; 

lastError = ComDlgExtendedErrorO; 

if (printDlg.hDevMode != NULL) G1oba1Free(printDlg.hDevMode); 

if (printDlg.hDevNames != NULL) G1obalFree(printDlg.hDevNames); 

return hdcPr; 

} // CPrint::PrintDialog 

j-trk -- irk/ 

DWORD CPrint::PrinterSetupDialog(void) { 

DWORD dwStatus = TRUE; 

printDlg.Flags = PD_PRINTSETUP; 

if (PrintDlg(JprintDlg)) dwStatus = TRUE; 

else dwStatus = FALSE; 

lastError = ComDlgExtendedErrorO; 

if (printDlg.hDevMode) GlobalFreefprintDlg.hDevMode); 

if (printDlg.hDevNames) GlobalFree(printDlg.hDevNames); 

return dwStatus; 

} // CPrint::PrinterSetupDialog 

/** . **/ 

DWORD CPrint;:DocumentStart(HINSTANCE hlnst) { 
if (hdcPr = NULL) hdcPr = PrintDialogO; 
bAbort = FALSE; 

hDlgAbort = CreateDialogthlnst, (LPSTR)"D1 gAbort”, hWnd, 

(DLGPROC)AbortDlg); 

SetAbortProcChdcPr, (ABORTPROC)AbortProc); 
return StartDocChdcPr, Sdoclnfo); 

) // CPrint:;StartDocument 

/** . **/ 


Creating the CPrint Class 

To demonstrate the use of the common print dialogs 
and the print job control functions, I wrote a simple C++ 
class called CPrint. The declaration and methods for this 
class are in cprint.h (Listing 1) and cprint. cpp (Listing 2). 

The constructor for CPrint takes as parameters a win¬ 
dow handle and the name of the document to print (this 
name shows up in the Print Manager while the job is 
pending). The constructor initializes some variables, includ¬ 
ing some members of the PRINTDLG and DOCINFO data struc¬ 
tures (see Figure 3). The PRINTDLG data structure is passed 
to Pri ntDl g() to control display of the common print dia¬ 
logs. Although the common print dialogs can be heavily 
customized, for simplicity I used default settings. The DO¬ 
CINFO structure is used later in a call to StartDocO. The 
destructor, ~ CPrintO, closes the printer DC if it is currently 
open. 

PrintDialogO sets the Flags field of the PRINTDLG struc¬ 
ture to PD_RETURNDC and calls PrintDlg!) to display the Print 
common dialog. If the user chooses OK in the Print dialog, 
a printer DC is created for the default printer and returned 
from PrintDlg!). PrintDialogO saves the DC in a member 
variable and returns it to the caller. PrintDialogO also 
saves the driver name, the device name, and the port 
name in member string variables that can be accessed by 
the caller at a later time. 

PrinterSetupDialogO similarly sets the Flag field of the 
PRINTDLG structure to PDJRINTSETUP and calls PrintDlg!). 


Windows Tools 


' Ad Oculos 

The low cost SDK 
for industrial 
image analysis 

Multiple fonts and / More than 50 powerful 
paragraph formatting / algorithms with source code 
Optional image import / Easy integration of user-defined 
with 1C Image-Control / algorithms 

Visual Basic interface / More than 20 sample applications 

Macrofields / Needs no additional hardware 

RTF filter,... / Award for best scientific software 1992 

Get your free TX demo today! Text book on the basics of 
image processing with Ad Oculos demo: $49 

Call 913 832 2070 (North and South America) 

ESC, Fax 913 832 8787, CompuServe 71 141,3624 

Elsewhere contact: DBS GmbH, Germany, 

+49 421 2208 161, Fax: +49 421 2208 273 
CompuServe 100013,115 

Or download TXDEMO.ZIP and AODEMO.ZIP from 
CompuServe, Forum WINSDK, Section Public Utilities 
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TX Text-Control 

A full-featured word 
processor within a 
DLL 



Finally! C++ Custom Controls 

Ted Faison’s new winPAK™ custom controls are written entirely in C++ and OWL 2.0. 

Derive your own classes - Change any feature you want, disable features, 
or even add entirely new ones, using standard C++ inheritance. All member functions 
are virtual, so you can change any control feature. Here are some of the controls 
included in the package: 



pc 

Validated input controls 

fen 

Analog gauges, in hundreds 
of different styles 

SI 

Hierarchical listboxes, as 
in BC4’s project manager 

1 

f 

Horizontal and vertical faders 
to adjust analog variables 

MS 

Bitmapped listboxes, with 
horizontal scrollbars 

70 V. 

Progress Indicators 
in dozens of styles 

E 

Enhanced controls 

7 

.. ■£■ . 

Help tool, to build your own 
help systems without coding 


Spreadsheet controls, with 
full ODBC database access 

0 

Knobs, in dozens of styles 

i 

ODBC compatible 

Form controls 


Readouts, in text, LED, or 
odometer formats 


Data-aware Controls - most WinPAK controls can be tied to database fields, 
to variables, or to other controls, using Resource Workshop. 

Customize your controls graphically - Forget archaic Visual Basic-style 
properties! winPAK controls have a built-in full-featured graphical designer, so you 
can design and customize controls interactively using the mouse. winPAK is fully 
compatible with Borland Resource Workshop. 

Reuse our winPAK Component Classes™ - All winPAK controls were 
implemented using our C++ Component Classes. These classes can be used to 
create entirely new object-oriented custom controls. 

Introductory Price $99.95 - Regular price $249.95. WinPAK with source 
code $499.95. No royalties. Full 30 day money back guarantee. To order, call (714) 
854-6535 or (800) 500-6535. FAX (714) 854-6459. VISA, MasterCard accepted. 


Faison Computing Inc. 4199 Campus Drive #550 Irvine, CA 92715 
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This displays the Printer Setup common dialog, which al¬ 
lows the user to select and configure printers. 

Both PrintDialogO and PrinterSetupDialogO set the 
member variable lastError to the value returned by 
CommDlgExtendedErrorO. CommDlgExtendedErrorO returns the 
most recent error to have occurred during execution of 
any of the common dialogs. The common print dialogs 
use the error range of 0x1000 to 0x1 FFF (PDERR_*). 

DocumentStartO first calls PrintDialogO to return a 
printer DC if there is no valid printer DC open. Document¬ 
StartO also hides most of the work involved in setting up 
an abort dialog box and an abort procedure for the print 
job. For simplicity, I assume that a dialog box template 
named 'DlgAbort' exists and that I can access it using the 
instance handle passed to DocumentStartO. The dialog box 
template has only two restrictions: it can have only one 
control (a Cancel button), and it must have a static text 
field with the identifier IDJOCTITLE (which I defined to be 
9000). DocumentStartO creates a modeless dialog box us¬ 
ing AbortDlgO as the dialog box procedure. Implementing 
callback functions as member functions is rather compli¬ 
cated, so, again, for simplicity, i made both the dialog box 
procedure (AbortDlgO) and the abort procedure (Abort- 
ProcO) standard functions in the cprint.cpp file. Finally, 
DocumentStartO calls StartDocO. 

The PageStartO, PageEndO, and DocumentAbortO methods 
simply call the corresponding Win32 routines: StartPageO, 


Listing 2 continued 


DWORD CPrlnt::PageStart(void) { return StartPage(hdcPr): } 

/**--**/ 

DWORD CPrlnt::PageEnd(void) { return EndPage(hdcPr); } 

/**----**/ 

DWORD CPrint::DocumentAbort(vo1d) { return AbortDoc(hdcPr); } 

/** —. *+y 

DWORD CPrint::DocumentEnd(void) { 
if UbAbort) DestroyWindow(hDl gAbort): 
return EndDoc(hdcPr); 

) // CPrint::DocumentEnd 

/**.**/ 

LRESULT CALLBACK AbortDlg(HWND hDlg, UINT msg, WPARAM wParam, 
LPARAM IParam) { 
switch(msg) ( 

case WMJNITDIALOG: 

SetDlgltemTextChDlg, IDC_DOCTITLE, 1pDocTitle): 
return TRUE; 
case WMCOMMAND: 
bAbort = TRUE; 

DestroyWindow(hDT g); 
hDlgAbort = 0; 
return TRUE; 

} return 0; 

} // AbortDlg 

/** . **/ 

BOOL CALLBACK AbortProcIHDC hDC, int iCode) { 

MSG msg; 

while UbAbort Si PeekMessageCimsg,NULL.0.0.PM_P.EM0VE)) { 
if UhDlgAbort II !IsDialogMessageChDlgAbort, &msg)) { 
TranslateMessage(Smsg); 

DispatchMessage(imsg); 

} 

} return !bAbort; 

} // AbortProc 

/* end of file */ 


Figure 3 PRINTDLG and DOCINFO data structures 


PRINTDLG Data Structure 

// Contains information the operating system uses to 
// initialize the system-defined Print dialog boxes, 
typedef struct tagPD { 


DWORD 

IStructSize; 

HWND 

hwndOwner; 

HANDLE 

hDevMode; 

HANDLE 

hDevNames; 

HDC 

hDC; 

DWORD 

Flags; 

WORD 

nFromPage; 

WORD 

nToPage; 

WORD 

nMinPage; 

WORD 

nMaxPage; 

WORD 

nCopies; 

HINSTANCE 

hlnstance; 

DWORD 

1CustData; 

LPPRINTHOOKPROC 1pfnPrintHook: 

LPSETUPHOOKPROC 

IpfnSetupHook; 

LPCSTR 

1pPrintTemplateName; 

LPCSTR 

1pSetupTemplateName; 

HANDLE 

hPrintTemplate; 

HANDLE 

hSetupTemplate; 

} PRINTDLG; 



DOCINFO Data Structure 

// Contains the input and output filenames used by the 
// StartDoc function, 
typedef struct { 

int cbSize; // size in bytes of struct 

LPTSTR IpszDocName; // name of document 

LPTSTR IpszOutput; // name of output file 

} DOCINFO; 


Listing 3 ntprint.cpp 


// NTPRINT.CPP Windows NT, MS Visual C/C++ (32-bit) 1.1 
//include <windows.h> 

#include "ntprint.h" 

#include "cprint.h" 

//include "cform.h" 


HINSTANCE hlnst; // app instance 

char szAppNamef] = "NTPrintSample"; // app name 

char lpNamet] = "Index Card"; // new form name 

char lpString[128], lpStrl[128]; // temp strings 

CPrinterForm form; // form object 

/**--.**/ 


int API ENTRY WinMain(HINSTANCE hlnstance, HINSTANCE 
hPrevInstance, LPSTR lpCmdLine, int nCmdShow) { 

MSG msg; 

lpCmdLine; // just to avoid an unused formal parameter 
if (!InitApplicationChlnstance, nCmdShow)) return FALSE; 
while (GetMessageUmsg, NULL, 0, 0)) { 
TranslateMessage(Smsg); 

DispatchMessage(Smsg); 

} return msg.wParam; 

) // WinMain 

/**.**/ 

BOOL InitApplication(HINSTANCE hlnstance, int nCmdShow) { 
HWND hWnd; 

WNDCLASS wc; 

wc.style = CSJREDRAW I CSJREDRAW; 
wc.lpfnWndProc = (WNDPROC)WndProc; 
wc.cbClsExtra = wc.cbWndExtra = 0; 
wc.hlnstance = hlnstance; 
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Listing 3 continued 


wc.hlcon = LoadlconCNULL, IDI APPLICATION); 


wc.hCursor = LoadCursor(NULL, IDC ARROW); 

HPALETTE hPal = CreateHalftonePalette(hDC); 

wc.hbrBackground = (HBRUSH)(COLOR WINDOW+1); 

SelectPalette(hDC, hPal, TRUE); 

wc.lpszMenuName = wc.lpszClassName = szAppName; 

RealizePalette(hDC); 

if (IRegisterClass(&wc)) return FALSE; 

GetColorAdjustment(hDC, (LPCOLORADJUSTMENT)&ca); 
ca .caBrightness = 50; 

hlnst = hlnstance; 

SetColorAdjustmentthDC, (LPCOLORADJUSTMENT)&ca); 

if (KhWnd = CreateWindowtszAppName, 

StretchBltthDC, 0, 0, (int)((float)bm.bmWidth * sx). 

"Sample NT Printing Application", WS OVERLAPPEDWINDOW, 

(int)((f1oat)bm.bmHeight * sy), hMemDC, 0,0, bm.bmWidth, 

CW USEDEFAULT, 0, CW USEDEFAULT, 0, NULL, NULL, 

bm.bmHeight, SRCCOPY); 

hlnstance, NULL))) return FALSE; 

DeleteDC(hMemDC); 

ShowWindowdiWnd, nCmdShow); 

DeleteObject(hBmp); 

UpdateWindow(hWnd); 

} // DrawOnSurface 

return TRUE; 


} // InitApplication 

/**...**/ 

void PrintingThread(LPVOID hWnd) { 

/**.....**/ 

CPrint printthWnd, "Document.pit"); 

LRESULT CALLBACK WndProc(HWND hWnd, UINT msg, WPARAM uParam, 

HDC hPDC, hDC; 

LPARAM IParam) { 

float fxl, fx2, fyl, fy2, fsx, fsy; 

switch (msg) { 


case WM COMMAND; 

if (KhPDC = print.PrintDialogO)) return; 

switch (LOWORD(uParam)) { 

if (I(GetDeviceCaps(hPDC, RASTERCAPS) J RCJITBLT)) return; 

case IDM PRINT: 


DWORD dwThreadID; 

hDC = GetDC(hWnd); 

CloseHandle(CreateThread(NULL, 0, 

fxl = (f 1 oatJGetDeviceCaps(hDC, LOGPIXELSX); 

(LPTHREAD START ROUTINE)PrintingThread, 

fyl = (f1 oat)GetDeviceCaps(hDC, LOGPIXELSY); 

(LPVOID)hWnd, 0, MwThreadID)); 

fx2 = (floatIGetDeviceCaps(hPDC, LOGPIXELSX); 

break; 

fy2 = (floatJGetDeviceCaps(hPDC, LOGPIXELSX); 

case IDM PRINTSETUP: { 

if (fxl > fx2) fsx = (fxl/fx2); 

CPrint print(hWnd, "Document.pit"); 

else fsx = (fx2/fxl); 

print.PrinterSetupDialog(); 

if (fyl > fy2) fsy = (fyl/fy2); 

) break; 

else fsy = (fy2/fyl); 

case IDM ENUMFORMS: 

ReleaseDCthWnd, hDC); 

DialogBoxthlnst, "DlgForms", hWnd, 


(DLGPROC)EnumDlgProc); 

print.DocumentStartthlnst); 

break; 

print. PageStartO; 

case IDM ADDFORM: 

DrawOnSurfacethPDC, hWnd, fsx, fsy); 

form. AddOpName,76200,127000,0,0,76200,127000); 

print. PageEndO; 

break; 

print. DocumentEndO; 

case IDM CHANGEFORM: 

} // PrintingThread 

form. Set(1 pName,127000,177800,0,0,127000,177800); 


break; 

/**---**/ 

case IDM DELETEFORM: 

LRESULT CALLBACK EnumDlgProc(HWND hDlg, UINT msg. 

form. Deleted pName); 

WPARAM wParam, LPARAM IParam) { 

break; 

long i, dx, dy, If, tp, rt, bt; 

case IDM EXIT: 

switch (msg) { 

DestroyWindow (hWnd); 

case WM_INITDIALOG: 

break; 

for (i = 0; (DWORD)i < form.dwForms; i++) { 

default: 

form.Enumerate((DWORD)i, IpString); 

return DefWindowProcthWnd, msg, uParam, IParam); 

SendDlgItemMessage(hDlg. IDC FORMS, LB ADDSTRING. 

} break; 

0, (int)(LPSTR)1pString); 

case WM PAINT: { 

) return TRUE; 

PAINTSTRUCT ps; 

case WM COMMAND: 

HDC hDC = BeginPaint(hWnd, &ps); 

switch (LOWORD(wParam)) { 

DrawOnSurfacethDC, hWnd, 1, 1); 

case IDC FORMS: 

EndPaint(hWnd, &ps); 

if (HIWORD(wParam) == LBN.DBLCLK) { 

} break; 

i = SendDlgltemMessage(hDlg, IDC FORMS, 

case WM DESTROY: 

LB GETCURSEL, 0, 0): 

PostQuitMessage(0); 

SendDlgItemMessage(hDlg, IDC FORMS, 

break; 

LB.GETTEXT, i, (int)(LPSTR)1pString); 

default: 

form.GetdpString, Mx, My, &lf, &tp, &rt, &bt); 

return DefWindowProcthWnd, msg, uParam, IParam); 

wsprintfdpStrl, "Form: %s\nWd: %1 d\nHt: %ld", 

} return 0; 

IpString, dx, dy); 

} // WndProc 

MessageBoxChDlg, IpStrl, "Get Form Info", MB_OK); 

) return TRUE; 

/**.....**/ 

case IDOK: 

void DrawOnSurfacetHDC hDC, HWND hWnd, float sx, float sy) { 

EndDialog (hDlg, TRUE); 

BITMAP bm; 

return TRUE; 

COLORADJUSTMENT ca; 

} break; 

HDC hdc = GetDC(hWnd); 

} return FALSE; 

HANDLE hMemDC = CreateCompatibleDC(hdc); 

} // EnumDlgProc 

ReleaseDC(hWnd, hdc); 

// End of File 

HANDLE hBmp = LoadBitmap(hlnst, MAKEINTRESOURCE(IDB_WINLOGO)); 
SelectObjectdiMemDC, hBmp); 

GetObject(hBmp, sizeof(BITMAP), (LPSTR)ibm); 
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EndPageO, and AbortDocO. The caller is not required to pass 
in the handle to the printer DC because the CPrint object 
already has access to the printer DC through a member 
variable. The DocumentEnd() method destroys the abort dia¬ 
log box (if it hasn't already been canceled) and calls End- 
DocO. 

The abort dialog box procedure, AbortDlgO, initializes a 
static text control to the name of the document that was 
passed to the constructor. If the Cancel button is pressed, 
AbortDlgO sets bAbort flag to TRUE and destroys the dialog 
box. The abort procedure (AbortProcO) contains a fairly 
standard PeekMessageO loop to allow other applications to 
process their messages. When an abort procedure is regis¬ 
tered using SetAbortProcO, the system guarantees that the 
abort procedure will be called periodically, usually every 
couple of seconds. If the abort procedure returns a 
nonzero value, the system responds by aborting the cur¬ 
rent print job. AbortProcO returns the negated value of the 
bAbort flag, so that the print job will be aborted whenever 
the bAbort flag is set to TRUE. 


Figure 4 COLORADJUSTMENT data sturcture 


COLORADOUSTMENT Data Structure (Win32) 

// defines color adjustment values used by StretchBlt and 
// StretchDIBits when StretchBltMode is HALFTONE 
typedef struct tagCOLORADJUSTMENT { 

WORD caSize; // size of structure in bytes 

WORD caFlags; // specifies how image is prepared 

WORD callluminantlndex; // luminance of light source 
WORD caRedGamma; // 2500-65000, 10000=no correction 

// 2500-65000, 10000=no correction 
// 2500-65000, 10000=no correction 
// 0-4000, darker colors are black 


WORD 

WORD 

WORD 


caGreenGamma; 
caBlueGamma; 
caReferenceBlack; 
caReferenceWhite; 
SHORT caContrast; 

SHORT caBrightness; 
SHORT caCol orful ness; 
SHORT caRedGreenTint; 


} COLORADJUSTMENT; 


lighter colors are white 
-100 to 100, 0 = no adjustment 

-100 to 100, 0 = no adjustment 

-100 to 100, 0 = no adjustment 

-100 to 100, 0 = no adjustment, 

// positive adjusts more towards red, 

// negative adjusts more towards green 


Listing 4 ntprint.h 

/* NTPRINT.H Windows 

NT, MS Visual C/C++ (32-bit) 1.1 */ 

//define IDM EXIT 

3000 

//define IDM PRINT 

3001 

//define IDM PRINTSETUP 

3002 

//define IDM ENUMFORMS 

3003 

//define IDM ADDFORM 

3004 

//define IDM CHANGEFORM 

3005 

//define IDM DELETEFORM 

3006 

//define IDNULL 

-1 

//define IDC FORMS 

4000 

//define IDB WINLOGO 

5000 

BOOL InitApplication(HANDLE, int); 

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM); 

void DrawOnSurfacetHDC, 

HWND hWnd, float, float); 

void PrintingThread(LPVOID); 

LRESULT CALLBACK EnumDlgProc(HWND, UINT, WPARAM, LPARAM); 

/* End of File */ 



Listing 5 natprint.rc 


/* NTRPINT.RC Windows NT, MS Visual C/C++ (32-bit) 1.1 */ 
//include "windows.h" 

//include "ntprint.h" 

//include "cprint.h" 

IDB_WINL0G0 BITMAP winlogo.bmp 

NTPrintSample MENU 
BEGIN 

POPUP "AFile" { 

MENUITEM "APrint.. 

MENUITEM "PArint Setup...", 

MENUITEM SEPARATOR 
MENUITEM "AEnumerate Forms. 

MENUITEM "AAdd Form", 

MENUITEM "AChange Form", 

MENUITEM "ADelete Form", 

MENUITEM SEPARATOR 
MENUITEM "EAxit", 

} 

END 

DlgForms DIALOG 16, 16, 118, 94 
LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US 
STYLE DS_MODALFRAMEIWS_POPUP|WS_VISIBLE|WS_CAPTION|WS_SYSMENU 
CAPTION "Forms (default printer)" 

FONT 8, "MS Sans Serif" 

BEGIN 

LISTBOX IDC_F0RMS, 10, 10, 98, 60, WS_VSCROLL|WS_TABSTOP 
PUSHBUTTON "OK", IDOK, 68, 70, 40, 14 
END 

DlgAbort DIALOG 16, 16, 156, 72 

LANGUAGE LANG_ENGLI$H, SUBLANGJNGLISHJJS 

STYLE DS_M0DALFRAME I WS_P0PUP I WSJISIBLE I WS_CAPTION 

CAPTION "Sample Application" 

FONT 8, "MS Sans Serif" 

BEGIN 

CTEXT "Printing", IDNULL, 10, 10, 135, 8 
CTEXT "(Untitled)", IDC_DOCTITLE, 10, 20, 135, 8 
PUSHBUTTON "Cancel", IDCANCEL, 53, 48, 49, 14 
END 


Listing 6 cform.h 


// CFORM.H Windows NT, MS Visual C/C++ (32-bit) 1.1 
//include (windows.h> 

//define BUFJIZE 10240 

class CPrinterForm { 
public: 

CPrinterForm(void); 

CPrinterFormtLPSTR lpName); 
virtual -CPrinterForm(void); 

BOOL Enumerate(DWORD iIndex, LPSTR lpName); 

BOOL AddlLPSTR, long, long, long, long, long, long); 

BOOL Delete!LPSTR); 

BOOL Get(LPSTR, long*, long*, long*, long*, long*, long*); 
BOOL Set(LPSTR, long, long, long, long, long, long); 

DWORD dwForms; 
private: 

// prevent copy by declaring without defining 
CPrinterForm(const CPrinterFormA); 
const CPrinterFormA operator=(const CPrinterFormA); 
void CPrinterForm::FillForm(FORM„INFO_l *, LPSTR, long, 
long, long, long, long, long); 

HANDLE hPrinter; 

BYTE 1pData[BUF_SIZE]; 

FORMJNFOJ *pFI; 

DWORD dwSize; 

}; // CPrinterForm 
/* End of File */ 


IDM_PRINT 
IDM_PRINTSETUP 

IDM_ENUMFORMS 

IDM_ADDFORM 

IDMJHANGEFORM 

IDM_DELETEFORM 

IDM_EXIT 
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Using the CPrint Class 

To demonstrate using the CPrint class, I wrote a very 
simple Win32 application (ntprint.exe). Source for the ap¬ 
plication is in Listings 3, 4, and 5 (ntprint.cpp, ntprint.h, 
ntprint.rc). In UinMainO, you'll notice that ! don't pay any 
attention at all to the hPrevInstance parameter. In Win¬ 
dows NT, the instance handle is actually the base address 
of the executable after it's mapped into its private address 
space. Since different instances of an executable will load 
at the same base address, but in different address spaces, 
all instances of an executable will have the same instance 
handle. But since window classes aren't shared in Win¬ 
dows NT, each instance needs to register its own window 
classes. The system always passes NULL for the value of 
hPrevInstance, so you can safely eliminate the check or 
leave it in for backwards compatibility. 

The main window procedure, UndProcO, in response to 
a UM_PAINT message, passes a handle to a display device 
context to DrawOnSurfaceO. DrawOnSurfaceO also takes as 
parameters a window handle and x and y scaling factors 


(in this case, both scaling factors are 1). DrawOnSurfaceO 
loads a bitmap from the application's resources (I just used 
the UINL0G0.BMP bitmap file), it next asks the graphics en¬ 
gine to create a halftone palette for this device context, 
and then selects and realizes the logical halftone palette 
into the device context. The code also demonstrates the 
use of the new Win32 GetColorAdjustmentO and SetCol- 
orAdjustmentO routines. The values specified in the COL- 
ORADJUSTMENT data structure (see Figure 4) are used by sub¬ 
sequent calls to StretchBltO and StretchDIBitsO if the 
StetchBltMode is HALFTONE (the default for Win32). You 
can set StretchBltMode by calling SetStretchBltModeO. Al¬ 
though the HALFTONE mode is typically a little slower 
than other StretchBItModes, it usually yields higher image 
quality. For demonstration purposes, I increased the 
brightness before drawing the bitmap to the device con¬ 
text. 

in response to a user selecting the "Print..." menu item, 
UndProcO creates a thread that executes the Print- 
ingThreadO routine. Printing is commonly implemented as 


Listing 7 cform.cpp 


II CFORM.CPP Windows NT, MS Visual C/C++ (32-bit) 1.1 
//include <windows.h> 

//include "cform.h" 

/**...**/ 

CPrinterForm::CPrinterForm(void) { 
dwForms = 0; 
dwSize = BUFJIZE; 

HKEY hKey; 

RegOpenKeyEx(HKEY_CURRENT_USER, "Printers", 0, 
KEY_QUERY_VALUE, &hKey); 

RegQueryValueEx(hKey, "Default", 0, NULL, lpData, AdwSize); 
RegCloseKey(hKey); 

if (OpenPrinter((LPTSTR)1pData, HhPrinter, NULL)) 
EnumFormsthPrinter, 1, (LPBYTE) 1 pData, BUFJIZE. 

SdwSize, AdwForms); 

} // CPrinterForm(void) 

/** .. **/ 

CPrinterForm::CPrinterForm(LPSTR pName) { 
dwForms = 0; 

if (OpenPrinter(pName, AhPrinter, NULL)) 

EnumFormsthPrinter, 1, (LPBYTE)lpData, BUFJIZE. 

SdwSize, MwForms): 

) // CPrinterFormtLPSTR) 

/**...**/ 

CPrinterForm::-CPrinterForm(void) { 

if (hPrinter 1= NULL) ClosePrinter(hPrinter); 

} // -CPrinterForm 

/** .. **/ 

BOOL CPrinterForm::Enumerate!DWORD ilndex, LPSTR 1pName) { 
if (ilndex ==011 dwForms == 0) { 

EnumFormsthPrinter, 1, (LPBYTE)!pData. BUFJIZE, 

SdwSize, AdwForms); 

} 

if (ilndex >= dwForms) return FALSE; 
pFI = (FORMJNFOJ *)lpData; 
lstrcpydpName, pFI[ilndex].pName); 
return TRUE; 

) // CPrinterForm:Enumerate 

/** ... **/ 

BOOL CPrinterForm::Add(LPSTR 1pName, long width, long height, 
long left, long top, long right, long bottom) { 


FORMJNFOJ fi; 

Fi11Form(&fi, 1pName. width,height,left,top,right,bottom); 
return AddForm(hPrinter, 1, (LPBYTE)Afi); 

} // CPrinterForm::Add 

/** .... **/ 

BOOL CPrinterForm::Delete(LPSTR 1pName) { 
return DeleteForm(hPrinter, 1pName); 

} // CPrinterForm::Delete 

/** .... **/ 

BOOL CPrinterForm::Get(LPSTR lpName, long *width, long *height, 
long *1 eft, long *top, long *right, long *bottom) { 

BYTE IpBuff[BUFJIZE]; 

FORMJNFOJ *p; 

GetFormt hPri nter, 1 pName, 1, (LPBYTE) 1 pBuff,BUFJIZE,&dwSize); 
p = (FORMJNFOJ *) 1 pBuff; 

*width = p[0].Size.cx; 

♦height = p[0].Size.cy; 

♦left = p[0].ImageableArea.1 eft; 

♦top = p[0].ImageableArea.top: 

♦right = p[0].ImageableArea.right; 

♦bottom = p[0].ImageableArea.bottom; 
return TRUE; 

} // CPrinterForm::Get 

/** .... **/ 

BOOL CPrinterForm::Set(LPSTR lpName, long width, long height, 
long left, long top, long right, long bottom) { 
FORMJNFOJ fi; 

FillForm(&fi, lpName, width,height,left,top,right,bottom); 
return SetFormthPrinter, lpName, 1, (LPBYTE)Jfi); 

} // CPrinterForm::Set 

/** .... **/ 

void CPrinterForm::FillForm(FORMJNFOJ *p, LPSTR pName, 

long dy, long dx, long xl, long yl, long x2, long y2) { 
p->pName = pName; 
p->$ize.cx = dx; 
p->Size.cy = dy; 
p->ImageableArea.1 eft = xl; 
p->ImageableArea.top = yl; 
p->ImageableArea.right = x2; 
p->ImageableArea.bottom = y2; 

) // CPrinterForm:Jill Form 
// End of File 


Page 22 — Windows/DOS Developer’s Journal 


April 1994 





















a separate thread, since it allows the user to continue 
working in the application while the thread prints in the 
background. A word of caution: GDI objects aren't share¬ 
able among threads. I have not prevented a user from 
starting a new print job before the current print job is 
completed, so there could be multiple PrintingThreadO 
threads running in addition to the main thread. None of 
these threads can share GDI objects (such as a global han¬ 
dle to a font). However, each thread does get its own 
stack, so as I've implemented them, the threads create 
any GDI objects they need as local variables on their 
stacks. 

By closing the thread handle immediately after the 
thread is created, I let the system know that the main 
application thread won't be referencing the thread directly. 
This allows the system to free up any memory associated 
with the thread once the thread terminates. If the handle 
to the thread is extant, the system cannot free the mem¬ 
ory until the process terminates. 

PrintingThreadO allocates a CPrint object and calls 
PrintDialogO to display the common print dialog and re¬ 
turn a handle to the printer device context. Print¬ 
ingThreadO also checks whether the printer is capable of 
transferring bitmaps by using the RASTERCAPS index and 
comparing the return value with the RCJITBLT flag. To pre¬ 
serve the aspect ratio and size of the image when printed, 
1 calculate an x and y scaling factor using the logical reso¬ 


Figure 5 FORM_INFO_1 data structure 


F0RM_INF0_1 Data Structure (Win32) 

// Identifies a printer form 
typedef struct _F0RM_INF0_1 { 

LPTSTR pName; // name of form 

SIZEL Size; // width/height of form (.001 mm) 

RECTL ImageableArea; // printable area (.001 mm) 

} FORMJNFOJ; 


lution of the printer device context and the display device 
context. Finally, to print the image, I call DocumentStartO 
and PageStartO to signal the beginning of a print job. To 
draw the bitmap to the printer, I pass a printer DC to Dra- 
wOnSurfaceO, the same routine I use to draw the bitmap to 
the display surface. Then I end the print job by calling 
PageEndO and DocumentEndf). 

Creating the CPrinterForm Class 

Windows NT uses the term "form" to refer to a physical 
surface characterized by a descriptive name, a physical 
size, and an imageable (or printable, in this case) area that 
excludes any physical margins. The Registry contains a da¬ 
tabase of all forms available on all installed printers (on a 
per-server basis). When you add a new form using the 
Win32 form routines, you are adding to the list of forms a 
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Figure 6 Screen capture from NTPRINT.EXE 


user can choose from in the Print Manager. A given form 
will be displayed as an option for a particular printer only 
if it doesn't exceed the physical limitations of the current 
printer. You can also use the Print Manager to add new 
forms and specify which type of form is in each tray. 

To demonstrate the Win32 forms routines, I wrote a 
simple class (CPrinterFond) to enumerate, add, delete, get. 


and set printer forms. The declaration and methods for 
this class are in cform.h (Listing 6) and cform.cpp (Listing 7). 
The CPrinterForm class has two overloaded constructors. If 
a CPrinterForm object is allocated without any parameters 
being passed to the constructor, then I assume the caller 
is asking for forms available on the default printer. Alter¬ 
natively, a caller can pass a string containing the name of 
a printer. The prescribed way of determining the name of 
the default printer is to call EnumPrintersO with the 
PRINTER_ENUM_DEFAULT type. Unfortunately, using the 
PRINTER_ENUM_DEFAULT type with EnumPrintersO returns a suc¬ 
cess code but returns zero for the number of PRINT_INF0_1 
structures returned. As a workaround for this unexpected 
behavior, I just resorted to reading the name of the de¬ 
fault printer from the Registry under the HKEY_CUR- 
RENT_USER\Printers\Defauit key. Both constructors open the 
printer and save a handle to the printer in a member vari¬ 
able. Then the constructors enumerate the forms for that 
printer so that the dwForms member variable can be initial¬ 
ized to the number of forms currently available. The de¬ 
structor closes the handle to the printer. 

I wrote the EnumerateO method so that it would be easy 
to call in a loop of code. The caller passes an index and a 
pointer to a string to EnumerateO, which returns the corre¬ 
sponding form name. I didn't want to re-enumerate the 
forms each time EnumerateO is called in a loop, so I only 
call EnumFormsO if the index is zero or if there are currently 
no forms enumerated at all (if dwForms is zero). 
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The AddO method creates a new form based on the 
name and size information passed to it. It accomplishes 
this by filling in a FORMJHFOJ structure and calling 
AddFormO. DeleteO deletes a form matching the name 
passed to it (you can't delete a form that is enumerated 
by a printer). GetO takes the name of a form and returns 
the size and imageable area of that form. Set() takes the 
name of a form and changes its size and imageable area 
to the values passed to it. 

Using the CPrinterForm Class 

The sample ntprint.exe program also demonstrates us¬ 
ing the CPrinterForm class. When the "Enumerate Forms..." 
menu item is selected, UndProcO cre¬ 
ates a dialog box using EnumDlgProcO 
as the dialog box procedure. 

EnumDlgProcO uses the dwForms field of 
the globally allocated CPrinterForm 
and the EnumerateO method to enu¬ 
merate all of the forms available on 
the default printer. If a user double¬ 
clicks on an item in the listbox, I call 
Get() to retrieve information about 
the selected form (see Figure 6). No¬ 
tice that Win32 uses the high word 
of uParam for listbox notification 
codes, rather than the high word of 
IParam (as was the case for Win! 6). 

When the "Add Form' menu item 
is selected, I call AddO to add a sam¬ 
ple form called 'Index Card' to the 
forms database. The units of size are 
given as thousands of millimeters, so 
I multiplied the dimensions in inches 
(3" x 5") by a factor of 25,400. You 
can view the new form by selecting 
the "Enumerate Forms..." menu item 
again or by selecting the Print Man¬ 
ager "Forms..." menu item under the 
"Printer' menu. The "Delete Form' 
menu item deletes the newly created 
Index Card form by calling DeleteO. 

The 'Change Form' menu item 
changes the size of the Index Card 
form to 5" x 7" by calling SetO. 

Building the Source Code 

I used the 32-bit edition of Mi¬ 
crosoft Visual C++ 1.10 to develop, 
debug, and build all the source code 
listed in this article. I created a new 
project named NTPRINT and specified 
a Project Type of 'Windows applica¬ 
tion (.exe).’ I added ntprint.cpp, 
cprint.cpp, cform.cpp, and ntprint.rc 
to the project. I used defaults for all 
other project options. As always. Vis¬ 
ual C++ automatically created my 
makefile and all other necessary pro¬ 


ject files. The makefile ( ntprint.maty and the executable 
(ntprint.exe) are available on the code disk (see the Table 
of Contents for information). 
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Enumerating Processes in 
Windows NT 



Brian G. Myers 


The Win32 API can enumerate windows, child windows, window properties, 
dependent services, clipboard formats, metafile records, fonts and font families, 
pens and brushes, printers, printer drivers, print jobs, ports, resource languages, 
and resource types, but no API routine exists for enumerating the currently 
running processes. The means to correct the omission lurk deep in the system 
registry. 

A list of ID numbers for running processes might be useful, for example, 
when a debugger seeks a process to debug. But you can do much more by first 
passing a process ID to OpenProcessO and getting a handle in return. Assuming 
your user access token permits such actions, a handle lets you change a proc¬ 
ess's priority, read from and write to its address space, determine how long it's 
been running and how much processor time it uses, wait for it to end, and 
retrieve its closing error code. You can even create new threads within the 
other process. (Curious or devious readers may wish to know that the functions 
needed for all those actions are DebugActiveProcessO, SetPriorityClassO, Read- 
ProcessMemoryO, MriteProcessMemoryO, GetProcessTimesO, UaitForSingieObjectO, 
GetExitCodeProcessO, and CreateRemoteThreadO.) Though I won't have room here 
to enumerate threads as well as processes, you could easily extend my code to 
create an EnumThreadsO procedure as well, permitting a similar range of actions 
on foreign threads. 

I've implemented a process enumeration function in enumproc.c (Listing 1) 
that sifts through performance data from the system registry to pass back the 
name and ID of each running process. To use the library, compile the code and 
call the exported EnumProcessesO function from within your own program. You'll 
need to provide a callback function just as you would for any other enumera¬ 
tion function. Besides introducing the complex structure of performance data in 
the system registry, enumproc.c also shows how to implement enumeration pro¬ 
cedures generally. 

Understanding System Registry Performance Data 

Conceptually, the system registry is nothing more than a big bin where any 
application may store any information it likes. The system uses the registry to 
remember hardware and software configurations, File Manager associations, 


Brian Myers has written three Windows programming books for Sybex. The most re¬ 
cent, written with Eric Hamer, is Mastering Windows NT Programming. Brian works 
for Borland International and occasionally teaches Win32 programming through a 
university extension in Silicon Valley. He can be reached on CompuServe at 
73204,1224. 
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Windows NT 


OLE servers, the identities of different users on a single 
machine, and many other things as well. All the data is 
organized into keys, where each key represents a node 
on a hierarchical tree. Unlike most registry data, NT's per¬ 
formance data does not reside permanently in the regis¬ 
try. Instead, a request to read the nodes that correspond 
to performance data causes NT to gather the information 
on the fly. To get performance data, you read from 
subkeys of the node named HKEY_PERFORMANCE_DA TA. The 
subkeys hold data (or cause data to be gathered) about 
the CPU, the paging file, the disk, system memory, 
threads, processes, network drivers, and other objects. 

The performance data block must cope with informa¬ 
tion retrieved from a variety of systems, some of them 
remote, some of them perhaps not 
even running Windows NT. The set 
of objects and the types of values 
gathered could vary. The number 
and size of the structures in the data 
block is not considered constant, so 
the data needs to describe itself. Each 
structure in the block contains offsets 
for navigating to subsequent struc¬ 
tures. You move a pointer from struc¬ 
ture to structure by adding offsets to 
it. 

Figure 1 diagrams the perform¬ 
ance structures. Understanding the 
block of data requires learning a little 
terminology. An "object" is something 
whose performance you might want 
to watch. Disk drives, processes, and 
CPUs are types of objects. One type 
may have several instances. There 
are always many process objects, for 
example, but only one system object. 

For each object, the performance 
monitor tracks a set of values called 
"counters'. To monitor a process, for 
example, you might want to know 
when the process started, what its ID 
number is, what percentage of proc¬ 
essor time it has consumed, and how 
many file operations it has per¬ 
formed. For the system object, you 
might want to know the number of 
thread context switches occurring per 
second or the processor queue 
length. Each object has different 
counters, and each instance of an ob¬ 
ject has its own set of values for 
those counters. If ten processes are 
running, then you'll retrieve ten sets 
of counter values. 


The initial PERF_DATA_BLOCK structure tells how many 
kinds of objects are represented in the current sample. It 
also tells its own size, as do most of the structures, to help 
you find the PERF_OBJECT_TYPE structures that follow, one 
for each object type. If the object name is "Process," then 
it probably has 23 counters and many instances. Each 
PERF_OBJECT_ TYPE is followed by a string of 
PERF_COUNTER_DEFINITION structures, one for each of the ob¬ 
ject's counters. The definition structures do not contain 
values; they tell how to interpret the values once you find 
them. They tell whether a counter is a 32- or 64-bit value; 
a timer, a percentage, or an average; what calculations to 
perform before presenting the value; and whether the 
value should be displayed with a particular suffix such as 


Figure 1 The structure of performance data in the system registry 
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Listing 1 enumproc.c — Process enumeration code 

- 

/* .. . 

#endif 

ENUM PROC LIBRARY 


Library clients call EnumProcesses to list 

THREADLOCALt TITLE_INDEX_STRUCT, Index ); 

all the processes currently running. 
. */ 

/*. 

ENUMERATE PROCESSES (exported function) 

/* library must match caller’s UNICODE setting */ 

Call up the performance monitor data for 

//define UNICODE /* for windows headers */ 

process objects and pass some information 

//define STRICT 

about each existing process to the caller. 

Return TRUE if enumeration succeeds and 

//include <windows.h> 

FALSE if an error interrupts enumeration. 

//include <winperf.h> /* performance structures */ 

. */ 

//include <1 imits.h> /* UINT MAX */ 

BOOL WINAPI EnumProcesses ( PTSTR szComputerName, 

//include "enumproc.h" 

/*-. 

MANIFEST CONSTANTS 

UINT uProcessID, PROCESSENUMPROC ProcessEnumProc. 

LPARAM 1 Pa ram ) { 

PPERF DATA BLOCK pDataBlock = NULL; 

... .*/ 

PPERF_OBJECT_TYPE pObjectType; 

LONG INumProcesses; 

//ifdef UNICODE 

PPERFJNSTANCEJEFINITION pThisProcess; 

//define NULL CHAR UNICODE NULL 

i nt i; 

//el se 

PROCESSENUMDATA ProcessEnumData: 

//define NULL CHAR ’\0’ 

BOOL bFound = FALSE; 

I/endif 

BOOL bSuccess * TRUE; 

//define GET INDEX FAILURE UINT MAX 

/* get name string index values for process counters */ 

//define RESERVED 0 

if UGetTitlelndicest szComputerName )) 

//define BUFFER INCREMENT 1024 

returnt FALSE ); 

//define NAME BLOCK SUBKEY \ 


TEXTC'SOFTWAREWMi crosoftWWi ndows NT\ 

/* query performance monitor for process data */ 

WCur rentVersi onWPerf 1 i b\\009" ) 

ZeroMemoryt SProcessEnumData, 

sizeoftProcessEnumData ) ); 

/*... 

pDataBlock = LoadCounterDatat szComputerName, 

PROTOTYPES 

Index.ProcessIndexString ); 

. .*/ 

if UpDataBlock) 

returnt FALSE ); /* unable to load data */ 

PWSTR GetlnstanceNamet 


PPERF INSTANCE DEFINITION plnstance ); 

/* set a pointer to start of data for first object */ 

BOOL CollectCounterValuest 

pObjectType = (PPERF_OBJECT_TYPE) 

PPERF OBJECT TYPE pProcessObjectType, 

(( PBYTE JpDataBlock + pDataBlock->HeaderLength); 

PPERF INSTANCE DEFINITION pProcess, 


PPROCESSENUMDATA pProcessEnumData ); 

/* loop through objects to find Process object */ 

BOOL StoreProcessCounterValue( 

for (i=0; iKpDataBTock->NumObjectTypes ; i++) 

PPERF COUNTER DEFINITION pPerfCounterDef, 

{ 

PBYTE pCounter, PPROCESSENUMDATA pProcessEnumData ); 

if (pObjectType-SObjectNameTitlelndex 

PPERF INSTANCE DEFINITION Nextlnstancet 

*■ Index.ProcessIndexValue) { 

PPERF INSTANCE DEFINITION plnstanceDef ); 

bFound = TRUE; 

PPERF DATA BLOCK LoadCounterDatat PTSTR szComputerName, 

break; 

PTSTR pObjectlndexString ); 

} else ( /* next object */ 

BOOL GetTitlelndices( PTSTR szComputerName ); 

pObjectType = (PPERF OBJECT TYPE) 

PTSTR LoadNameStringst PTSTR szComputerName ); 

(( PBYTE)pObjectType 

UINT GetTitlelndexValue( PTSTR pNameBlock. 

+ pObjectType-XHeaderLength); 

PTSTR pTitle ); 

) 

PTSTR GetTitlelndexString( PTSTR pNameBlock, 


PTSTR pTitle ); 

) 

PTSTR NextStringC PTSTR pstr ); 

if (! bFound ) /* no processes found! */ 

UINT tstr_to_uint( PTSTR pNumString ); 

returnt FALSE ); /* (this shouldn't happen) */ 

/*. 

/* how many processes were found? */ 

GLOBAL VARIABLE 

INumProcesses = pObjectType-SNumlnstances; 

The Index structure holds title string index 


values for all the counters the library passes 

/* point to first process instance definition */ 

to its caller. It must be thread-local in case 

pThisProcess = (PPERF INSTANCE DEFINITION) 

concurrent threads retrieve performance data 

(( PBYTE)pObjectType 

from different machines. 

.*/ 

typedef struct ( 

+ pObjectType->DefinitionLength); 

/* Loop through all instances. Send info about */ 

UINT IDProcess; 

/* each process object back to the client program */ 

UINT ThreadCount; 

/* through its callback function, ProcessEnumProc. */ 

UINT PriorityBase ; 


UINT ProcessIndexValue; 

for (i = 0; i < INumProcesses; i++) { 

PTSTR ProcessIndexString; 


} TITLE_INDEX_STRUCT; 

/* Copy instance name to ProcessEnumData. */ 

/* If UNICODE is not defined, convert to */ 

//ifdef BORLANDC // BORLAND 

/* a narrow-character string. */ 

//define THREADLOCALt type, name ) type thread name 


//el se 

//ifdef UNICODE 

// MICROSOFT 

Istrcpyt ProcessEnumData.InstanceName. 

//define THREADLOCALt type, name ) \ 

GetlnstanceNameCpThisProcess ) ): 

_declspect thread ) type name 

//else 
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Listing 1 continued 

MldeCharToMultiByte( CP_ACP. 0. 

/* if caller wants info for this process, send it */ 

GetlnstanceName(pThisProcess). -1, 

if ((uProcessID == ENUM_PROCESSES_ALL) 

ProcessEnumData.InstanceName, 

II (uProcessID == ProcessEnumData.IDProcess)) { 

sizeof(ProcessEnumData.InstanceName), 


NULL, NULL ); 

if (IProcessEnumProct SProcessEnumData, IParam )) 

#endif 

break; /* caller wants no more data */ 

/* copy counter values to ProcessEnumData */ 


if (! CollectCounterValues ( pObjectType, 

/* point to the subsequent process */ 

pThisProcess. SProcessEnumData )) { 

pThisProcess « Nextlnstancet pThisProcess ); 

bSuccess = FALSE; /* no values found (this */ 

} 

break; /* (shouldn't happen) */ 


} 

LocalFree( Index.ProcessIndexString ); 


LocalFree( pDataBlock ); 


'/sec' or "%'. After the object types 
and their counter definitions come in¬ 
stance definitions - if there are in¬ 
stances - and counter blocks. In¬ 
stance definitions tell the name of 
the instance, if it has one. Counter 
blocks (at last!) contain all the actual 
counter values for one particular ob¬ 
ject instance. You can't interpret the 
counter block without referring back 
to the counter definitions. All these 
structures are defined in uinperf.h, 
which a program must include in or¬ 
der to read the data. 

Retrieving Object and 
Counter Names 

Because the kinds of performance 
data retrieved may vary on other 
systems, it is not safe to assume that 
a given object will always present the 
same counters in the same order. 
The PERF_COUNTER_DEFINITION structures 
give enough information to evaluate 
and display each counter value, but 
not enough to know exactly what 
the value represents. That informa¬ 
tion comes from a block of label 
strings stored separately in the regis¬ 
try. The counter definition structures 
contain index values that identify 
strings in the name block. To use the 
performance data, you usually have 
to read in both blocks: the data itself 
and the associated names. Table 1 
shows the structure of the name 
block. A double null marks the end 
of the list. The quotation marks 
shown in the table are of course not 
stored in the name block; they indi¬ 
cate that the entries are all strings. 
The name strings help to make the 
performance data self-describing. If a 


Windows/DOS Developer’s Journal — Page 29 


C-lndex/II 

Data Management Library 


Discov 


Leading software 
C-Index/II for their advanced r 
products and in-house applications 



C-Index/II: $695.00 

• Fast B+Tree Indexing 

• Unlimited File Size and Key Types 

• Complete Portable C Source Code 

• Any system with ANSI or K&R C 

• Nine Simple High-Level Functions 

• Over 60 Additional Functions 

• Multi-User and Single-User Access 

• Data and Indexes in Same File 

• Multiple Record Formats per File 

• No Application Royalties 

C-Index/PC: $195.00 

• Most of the features of C-Index/II 

• 32 Megabyte Files and String Keys 

• Complete C Source for MSDOS 


New Release 4.1 

PowerFail Protection 
Transaction Logging 
File Mirroring 
Fast Sequential Access 
Multiple B+Trees / File 
Windows NT Port 


Windows 3.x & Windows NT 
MSDOS UNIX PharLap 
Microsoft & Borland C/C ++ 


Call or Fax Today for Your Free Demo Kit 



Trio Systems 


936 E. Green St. Suite 105 
Pasadena, CA 91106 
818/584-9706 
818/584-0364 Fax 


□ Request 136 on Reader Service Card o 


April 1994 


















PERF_OBJECT_TYPE contains the value 4 in its ObjectNdmeTi- 
tlelndex field, then you can look in the name block to 
discover that the object type is 'Memory'. To perform the 
lookup you must convert the DWORD value 4 to the string 


"4," scan through the name block for the matching string, 
then return the string that follows '4.' 

If you find this proliferation of data blocks and struc¬ 
tures confusing, you might not want to know that the reg¬ 
istry also contains a parallel block of explanatory strings 


Listing 1 continued 

return! bSuccess ); 

Run through all the counters associated with 

} 

one process. Interpret counter values and copy 
them into fields of a PROCESSENUMDATA structure. 

/* . 

Return TRUE if any values are copied into 

GET INSTANCE NAME 

pEnumData. 

Given a pointer to an instance definition 

... . */ 

structure, return a pointer to the name of that 

BOOL Col 1ectCounterValues ( 

instance. Return a pointer to Unicode name 
string, if successful, or UNICODE_NULL if for 
any reason the name cannot be found. 

.*/ 

PWSTR GetlnstanceName ( 

PPERF OBJECT TYPE pObjectType. 

PPERF INSTANCE DEFINITION pProcess. 

PPROCESSENUMDATA pEnumData ) { 

UINT i; 

PPERF INSTANCE DEFINITION plnstance ) 

UINT uNumCounters; 

{ 

PPERF COUNTER BLOCK pCounterBlock; 

PWSTR pNameString; 

PPERF_COUNTER_DEFINITION pThisCounterDef; 

PBYTE pThisCounter; 

if (!plnstance) 

BOOL bSuccess = FALSE; 

pNameString = UNICODEJULL; 


else if ( (pInstance->NameLength != 0) 

uNumCounters = (UINT)pObj ectType->NumCounters; 

88 (pInstance->NameOffset != 0)) 


pNameString = ( PWSTR) (( PBYTElpInstance 

/* point to the first counter definition */ 

+ pInstance->NameOffset): 

pThisCounterDef = ( PPERF_COUNTER_DEFINITION ) 


( (PBYTE)pObjectType + pObjectType-AHeaderLength); 

return! pNameString ); 


} 

/*. 

COLLECT COUNTER VALUES 

/* point to the first counter block */ 
pCounterBlock = !PPERF_COUNTER_BLOCK) 

(Listing 7 is continued on page 34) 
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Table 1 The structure of the name block 

Index String 

Separator 

Name String 

Separator 

It^M 

NULL 

"System" 

NULL 

"4" 

NULL 

"Memory" 

NULL 

"6" 

NULL 

"% Processor Time" 

NULL 

[...] 




"822" 

NULL 

"Pages Input/sec" 

NULL NULL 
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to supplement the name strings. In 
the name block, '4' precedes 'Mem¬ 
ory,' and in the help block, it pre¬ 
cedes a long string of several sen¬ 
tences explaining what 'Memory' is. 
Patient readers can find all the labels 
and help strings for themselves by 
running the Performance Monitor ap¬ 
plication that comes with Windows 
NT. Pull down the Edit menu, choose 
Add To Chart, and click on the Ex¬ 
plain button. Figure 2 shows the re¬ 
sulting dialog box. When you choose 
an object, such as Thread, a list box 
displays all the counter names. Se¬ 
lecting a counter brings up the help 
text in the Counter Definition box. 
You don't have to worry about the 
help strings now, though, because 
EnumProcessesO doesn't use them. 

The LoadNameStringsO function in 
enumproc.c (Listing 1) reads the name 
block into memory. The names re¬ 
side under HKEY_LOCAL_MACHINE under a 
subkey with the cumbersome name: 
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S0FTWAREWM1 crosoft\\Wi ndows NTW 
CurrentVersionWPerfl ib\\009 


The final three digits of the string in¬ 
dicate a language. '009' stands for 
the default language, U.S. English. 
Under this node, ask for the subkey 
'Counters' to get the name strings or 
"Help' to get the explanatory strings. 

Loading the Data Block 

The other function that queries 
the registry is LoadCounterOataO, 
which returns a pointer to the block 
that holds all the performance struc¬ 
tures and counter values. If the caller 
passes in the name of a remote com¬ 
puter, then LoadCounterDataO begins 
by calling RegConnectRegistryO to 
open the HKEY_PERFORMANCE_DATA key 
on the remote machine. Next comes 
a loop that allocates a data buffer 
and then repeatedly enlarges it until 
the call to RegQueryValueExO succeeds. 
According to the Win32 documenta¬ 
tion for RegQueryValueExO, such a loop 
should not be necessary, if the buffer 
is too small, then the required size is 
returned through the function's last 
parameter, here called duDataSize. 
That's how LoadNameStringsO deter¬ 
mines the proper size for its buffer. 
Performance data, however, is an ex¬ 
ception. The quantity of performance 
data varies from moment to mo¬ 
ment. As the set of running processes 
grows or shrinks, so does the quan¬ 
tity of related performance data. Be¬ 
tween the time RegQueryValueExO fails 
once and the time you call it again, 
the system might start more proc¬ 
esses. Therefore when dwDataSize re¬ 
quests a buffer of a certain size for 
performance data, the value is unreli¬ 
able. 

The data buffers required for proc¬ 
esses are not huge. The performance 
data on my home machine fits easily 
into the library's initial 30Kb buffer, 
but my work machine, which is at¬ 
tached to a network and has to re¬ 
turn network data along with the 
process data, expands the buffer to 
about 63Kb. 

Here's the central command that 
actually loads the data block: 
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(Listing 7 continued from page 30) 


Listing 1 continued 


((PBYTE)pProcess + pProces$->ByteLengtti); 

for (i = 0; i < uNumCounters: 1++) { 

/* point to the counter data that */ 

/* corresponds to the counter definition */ 
pThisCounter = (PBYTE)pCounterBlock 

+ pThisCounterDef->CounterOffset; 

/* copy a counter value into pEnumData */ 
if (StoreProcessCounterValue( pThisCounterOef, 
pThisCounter, pEnumData )) 
bSuccess ■ TRUE; 

/* point to the next counter definition */ 
pThisCounterDef = (PPERF_COUNTER_DEFINITION) 
({PBYTE)pThisCounterDef + 
pThisCounterDef->ByteLength); 

} 

return! bSuccess ); 

) 

/*. 

STORE PROCESS COUNTER VALUE 
Interpret the value in pCounter and store it 
in the appropriate field of pEnumData. To 
interpret the value, the procedure needs to 
see the related counter definition structure. 

Returns TRUE if pCounter is identified and 
stored. 

. ---*/ 

BOOL StoreProcessCounterValue ( 

PPERF_COUNTER_DEFINITION pPerfCounterDef. 

PBYTE pCounter, PPROCESSENUMOATA pEnumData ) { 


dwResult = RegQueryValueEx ( 


HKEY_PERFORMANCE_DATA, 

TEXTC230"), 

NULL, 

&Type, 

(PBYTE)pDataBlock, 
WwDataSize ); 


/* key where data resides */ 

/* process name title index */ 

/* reserved */ 

/* data type returned here */ 

/* buffer pointer */ 

/* size of data copied to buffer */ 


HKEY_PERFORMANCE_DATA is a predefined key. The second pa¬ 
rameter names a subkey. The subkeys under HKEY_PERFORM- 
ANCEJATA take their names from the title index values in 
the name block (see Table 1). "230" is usually the index 
for the string "Process'. Change the subkey to gather infor¬ 
mation about different objects. "002," for example, re¬ 
trieves data for the system object. "700" gets data for the 
paging file. You can combine several numbers in one 
string. '234 236' gets data for both physical and logical 
disk objects. To monitor all objects at once, use the 
subkeys 'Global' and "Costly". 'Global' retrieves all the 
data that can be collected quickly. "Costly" retrieves the 
remaining counters but is likely to be slow. 

LoadCounterDataO ends by closing HKEY_PERFORMANCE_KEY. 
Opening the key was unnecessary because it is always 
open, but closing it is necessary because the system can¬ 
not install or remove components while they are being 
monitored. Network drivers, for example, are locked in 
place while being monitored until the performance data 
key is closed. 
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Finding Specific Counters 

In that somewhat breezy explanation I've ignored the 
difficulty of figuring out which index value belongs to 
which counter. The index numbers are not guaranteed to 
be constant across systems. 'Process' may not always be 
at index '230'. What is constant are the English object 
names such as 'Process'. So in order to retrieve thread 
data, for example, you have to: 


• Load the name block. 

• Search the block for the string 'Thread'. 

• Back up and find the string that precedes "Thread' 
(usually '232'). 

• Pass the string as a subkey name to RegQueryValueO or 
RegQueryValueExO. 

GetTitlelndicesO looks up the index values for some of 
the strings that pertain to processes and stores them in 


Listing 1 continued 

DWORD dwCounterIndex = 

(PBYTE)pCounters, AdwDataSize ); 

pPerfCounterDef->CounterNameTitlelndex; 



/* if there wasn't room, expand the buffer */ 

if (dwCounterlndex »* Index.ThreadCount) ( 

if (IResult = ERROR MORE DATA) { 

pEnumData->ThreadCount = ‘(PDWORD)pCounter; 

LocalFreet pCounters ); 

} else if (dwCounterlndex == Index.PriorityBase) { 

dwDataSize +• BUFFER INCREMENT; 

pEnumData->PriorityBase « *( PDWORDlpCounter; 

pCounters = (PPERF DATA BLOCK) 

} else if (dwCounterlndex ** Index.IDProcess ) { 

Local Alloc( LMEM FIXED, (UINT)dwDataSize ); 

pEnumData-MDProcess « *(PDWORDlpCounter; 

) 

} else 

/* if some other error occurred, quit */ 

return (FALSE); /* no value was stored */ 

else if (!pCounters) 


returnt NULL ); 

return( TRUE ): /* a value was stored */ 


} 

} while (IResult ~ ERROR_MORE_DATA); 

/*. 

/* close key so system won’t lock monitored objects */ 

NEXT INSTANCE 

RegCloseKey ( hPerfKey ); 

Given a pointer to an instance definition 

returnt pCounters ); 

structure, return a pointer to the next 

) 

instance definition structure that follows. 


PPERF INSTANCE DEFINITION Nextlnstance ( 

GET PROCESS COUNTER TITLE INDICES 

PPERF_INSTANCE_DEFINITION plnstanceDef 1 { 

Loads block of strings from performance 


monitor and searches for string index 

PPERF_COUNTER_BLOCK pCounterBlock; 

values for process-related counters. 


Stores the values in the global Index 

pCounterBlock = (PPERF COUNTERJLOCK) 

structure. Returns FALSE for errors. 

(( PBYTEIpInstanceDef + pInstanceDef->ByteLength); 

.*/ 


BOOL GetTitlelndices ( PTSTR szComputerName ) { 

return! (PPERF INSTANCE DEFINITION) 


((PBYTE)pCounterBlock + pCounterBlock->ByteLength ) ); 

PTSTR pstrNameBlock; 


pstrNameBlock = LoadNameStrings ( szComputerName ); 

/*. 

if (! pstrNameBlock) 

LOAD COUNTER DATA 

returnt FALSE ); 

Read from the performance monitor a block of 


data holding counter values for the given 

/* search data block for index numbers to */ 

object. Return a pointer to the data block. 

/* process counters */ 

which the caller must free, or NULL on errors. 

Index.ThreadCount = (UINT)GetTitlelndexValue( 

.*/ 

pstrNameBlock. TEXTC'Thread Count”) ); 

PPERF_DATA_BLOCK LoadCounterData ( 

Index.PriorityBase = (UINT)GetTitlelndexValue( 

PTSTR szComputerName, 

pstrNameBlock. TEXTC'Priority Base”) ); 

PTSTR pObjectTitlelndex ) { 

Index.IDProcess = (UINT)GetTitlelndexValue< 


pstrNameBlock, TEXTC'ID Process”) ); 

PPERF DATA BLOCK pCounters; 


DWORD dwDataSize = 30*BUFFER INCREMENT; /* 30k */ 

/* get string and value of index to object name */ 

LONG 1 Result; 

Index.ProcessIndexString « GetTitlelndexString( 

DWORD Type; 

pstrNameBlock. TEXTCProcess”) ); 

HKEY hPerfKey = HKEY PERFORMANCE DATA; 

Index.ProcessIndexValue * 


tstr_to_uint( Index.ProcessIndexString ); 

/* attempt a remote connection if caller requests it */ 


if (szComputerName) 

GlobalFreet pstrNameBlock ); 

l 

IResult = RegConnectRegistry( szComputerName, 

/* return TRUE if all indices were found */ 

HKEY PERFORMANCE DATA. AhPerfKey ); 

returnt (Index.ThreadCount 1= GET INDEX FAILURE) 

if (IResult 1= ERROR_SUCCESS) 

AS (Index.PriorityBase != GET INDEX FAILURE) 

returnt NULL ); 

AA (Index.IDProcess != GET INDEX FAILURE) 

} 

&& (Index.ProcessIndexString != NULL) ); 

/* allocate buffer for data (guessing its size) */ 


pCounters = (PPERF DATA BLOCK) 

/*. 

LocalA1 1 oc( LMEM FIXED, (UINT)dwDataSize ); 

LOAD NAME STRINGS 


Read in the block of object name strings. 

do { 

Return a valid pointer to the block of 

/* try to load the data */ 

MULTI SZ strings or NULL if an error occurs. 

IResult = RegQueryValueEx ( 

.*/ 

hPerfKey. pObjectTitlelndex, NULL. AType, 

PTSTR LoadNameStrings ( PTSTR szComputerName ) { 
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Listing 1 continued 

8 f®I| 


HKEY hNamesKey; 

/*. 


LONG 1 Result; 

GET TITLE INDEX STRING 


DWORD dwDataType; 

Search through the name block for the given 


DWORD dwOataSize; 

string pTitle. If found, copy and return 


PTSTR pstrNameBlock; /* points to block of name strings */ 

the corresponding index string (e.g. "230"). 


HKEY hMachineKey = HKEY_LOCAL_MACHINE; 

Caller must free the string. NULL return 
for errors. 


/* attempt a remote connection if caller requests it */ 

.*/ 


if (szComputerName) 

PTSTR GetTitl elndexStri ng ( 


{ 

PTSTR pstrNameBlock, PTSTR pTitle ) 


1 Result * RegConnectRegistry( szComputerName. 

( 


HKEY LOCAL MACHINE, ShMachineKey ); 

BOOL bEndOfData = FALSE; 


if (1 Result != ERRORJUCCESS) 

PTSTR pThisIndex. pThisTitle; 


return( NULL ); 

) 

PTSTR pReturn * NULL; 

if ((IpstrNameBlock) II (IpTitle)) { 


/* open the key where the block of names is kept */ 

return! NULL ); 


1 Result * RegOpenKeyEx! hMachineKey. 

NAME BLOCK SUBKEY, RESERVED, KEY QUERY VALUE, 

} 


AhNamesKey ); 

/* point to first two strings in the name block */ 


if (1 Result 1= ERRORJUCCESS) 

pThisIndex = pstrNameBlock; 


return! NULL ); 

pThisTitle * NextString! pstrNameBlock ); 


/* find out how big the data block is */ 

/* search through the name block for a match */ 


1 Result = RegQueryValueEx( hNamesKey, 

while UbEndOfData && 


TEXTC'Counters"), RESERVED, 

AdwDataType, NULL, AdwDataSize ): 

(1 strcmpCpT i tle, pThisTitle) != 0)) { 


if (1 Result != ERROR SUCCESS) 

pThisIndex = NextString! pThisTitle ); 


return! NULL ); 

if (*pThisIndex != NULLJHAR) 

pThisTitle = NextStri ng ( pThisIndex ); 


/* allocate room for all the names */ 

if (*pThisTitle == NULL CHAR) 


pstrNameBlock = (PTSTR) 

bEndOfOata = TRUE; 


GlobalAlloc! GMEM_ZEROINIT. dwDataSize ); 
if (!pstrNameBlock) 

} 


return! NULL ); 

/* if a match was found, copy and return the string */ 
if (!bEndOfData) { 


/* load all the names into the buffer */ 

pReturn * LocalA11oc( LPTR, 1strlen(pThisIndex)+1 ); 


1 Result = RegQueryValueEx! hNamesKey, 

if (pReturn) 


TEXT!"Counters”), RESERVED. AdwDataType, 

lstrcpy! pReturn. pThisIndex ); 


(PBYTE)pstrNameBlock, AdwDataSize ); 

} 


if (1 Result != ERROR SUCCESS) 

return! pReturn ); 


return! NULL ); 

) 


/* close the key that holds the names */ 

/*. 


RegCloseKey( hNamesKey ); 

NEXT STRING 


RegCloseKey! hMachineKey ); 

Return a pointer to the subsequent string in 

} 

/*— 

return! pstrNameBlock ); 

a data block of MULTI SZ strings. 

.*/ 

PTSTR NextString ( PTSTR pstr ) { 


GET TITLE INDEX VALUE 

if (pstr == NULL) 


Search through the name block for the given 
string pTitle. If found, convert the 

return! NULL ); 


corresponding index string (e.g. ”230") to 

while (*pstr != NULLJHAR) 


an unsigned integer. Return the integer, 
or if not found, return GET INDEX FAILURE. 

pstr++; 


. */ 

return! ++pstr ); 

UINT GetTitlelndexValue ( 



PTSTR pstrNameBlock, PTSTR pTitle ) { 

/*. 

TSTR TO UINT 


PTSTR plndexString; 

Convert the given string (e.g. "230") from 


UINT uValue = GET_INDEX_FAILURE: 

a TCHAR string to an unsigned integer. 


if ((IpstrNameBlock) II (IpTitle)) 

UINT tstr to uint ( PTSTR pNumString ) { 


return! GET_INDEX_FAILURE ); 

UINT uValue = 0; 


plndexString * GetTitlelndexString! 

while (isdigit! ‘pNumString )) { 


pstrNameBlock, pTitle ); 

uValue *= 10; 

uValue += (BYTE)*pNumString - TEXT!’0’); 


if (plndexString) ( 

pNumString++; 


uValue * tstr_to_uint( plndexString ); 

Local Free! plndexString ); 

} 


} 

return! uValue ); 

} 

/* End of File */ 

} 

return! uValue ); 
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the global variable Index. The function's purpose is to 
avoid hard-coding the index values. The task of searching 
for a string and returning its index is performed by GetTi- 
tlelndexStrlngO and GetTitlelndexValueO. Which you call 
depends on whether you want the index as a string or a 
number. One field of Index holds the string (usually "230') 
for reading the process object subkey from the perform¬ 
ance registry. The other Index fields store numbers for use 
in identifying process counters. You'll see how that works 
soon. 

The performance registry collects much more informa¬ 
tion about processes than I make use of here. I'm assum¬ 
ing that the point of enumerating processes is to get their 
names and ID numbers. If you need other, relatively eso¬ 
teric information such as the maximum amount of virtual 
address space the process has used at any one time or 
the rate of bytes transferred per second in the process's 
file I/O operations, then you probably want to work di¬ 
rectly with the performance registry yourself. To find out 
more about what information the registry holds and how 
to process more complicated counter values, you might 
begin with the comments in uinperf.h, but you'll want to 
end with Russ Blake's Optimizing Windows NT, the third 
volume of the Microsoft Windows NT Resource Kit, which 
is devoted entirely to performance-monitoring issues. 

Parsing the Data Block 

Parsing the data block requires many statements like 
this one, which advances a pointer from one PERF_0B- 
JECTJTYPE structure to the next: 

pObjectType = (PPERF_OBJECT_TYPE) ((PBYTE)pObjectType 

+ pObjectType->HeaderLength); 

Most of the structures have a HeaderLength or ByteLength 
field containing the offset in bytes to the next structure. 
For pointer arithmetic, you must cast the pointer to type 
PBYTE before adding the offset, then cast the result back to 
a structure pointer. Using sizeofO to calculate the offset 
doesn't always work because sometimes other data inter¬ 
venes between two structures. Each PERF_INSTANCE_DEFINI - 
TION structure is followed immediately by a variable-length 
string containing the instance name. In this case, the off¬ 
set from one instance definition to the next is the sum of 
the ByteLength and NameLength fields. 

All the strings stored in the registry as part of the data 
block or the name block are stored as Unicode strings. For 
the most part enumproc.dll doesn't care about the width of 
the characters because it uses generic character types such 
as TCHAR and PTSTR along with the TEXT macro and so 
works equally well with either width. When the UNICODE 
constant is not defined, RegQueryValueExO becomes the 
narrow-character function RegQueryValueExAO and silently 
converts all the strings in the name block to narrow char¬ 
acters. But the instance name, embedded in a complex 
structure containing many data types, cannot be con¬ 
verted automatically. As you'll see in enumproc.c, I've 
added an ti fdef to force the conversion if UNICODE is not 
defined. (UideCharToMultiByteO does not necessarily pro¬ 


duce multibyte characters; it produces normal one-byte 
characters unless the original string contains foreign char¬ 
acters that require multibyte representations.) My code as¬ 
sumes that the library and its client program are compiled 
with the same UNICODE setting. With UNICODE defined, enum- 
proc.dll passes process names to the client as Unicode 
strings. Without the UNICODE constant, it passes narrow- 
character strings. 

The EnumProcesses Procedure 

EnumProcessesO executes these steps: 

• Loads the name block and gets title index values for 
counter names. 

• Loads the data block. 

• Finds the PERF_OBJECT_TYPE structure for processes. 

• Finds the first PERFJNSTANCEJEFINITION structure. 

• For each instance: copies the process name and 
counter values into a structure; passes the structure 
back to the caller. 

Most of the variables in the program are dynamic 
rather than static, so issues of multithreading do not arise. 
Each thread pushes its own values onto its own stack. 
However, the program's one static variable, Index, must be 
thread-local. If EnumProcessesO always queried only the lo¬ 
cal machine, then all inquiries would use the same name 
block and there would be no need for thread-local in¬ 
stances of Index. But because remote inquiries could con¬ 
ceivably produce varying name blocks, each thread must 
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be allowed to keep its own version of the index values. 
My THREADLOCAL macro declares Index using the syntax re¬ 
quired for either the Borland or the Microsoft compiler. 

For the third step I've written a loop that walks through 
all the PERF_OBJECT_TYPE structures to find the one for proc¬ 
ess objects. Normally the loop is not necessary, because 
asking for process data yields only one object type ('Proc¬ 
ess'). Sometimes, however, asking for one object yields in¬ 
formation about several. The system can't monitor 
threads, for example, without monitoring processes as 
well, and it returns the information for both. Similarly, ask¬ 
ing for logical disk data pulls up physical disk data, too. 
The loop allows for the possibility that some other system 
might return multiple objects even for a process query, 
and it makes the code more easily adapted to inquiries 
about objects other than processes. 

EnumProcessesO calls CollectCounterValuesO to pick out 
the performance values for one process. CollectCounterlal- 
ues() loops through all the counters to read them. For 
each iteration it sets one pointer to a counter definition 
and another to the corresponding counter value. It passes 
both pointers to StoreProcessCounterValue(), which uses the 
counter definition to identify and interpret the data in the 
counter. When it finds the process's ID, priority, or thread 
count, it copies the value into the structure that is later 
passed to the client. 

Calling the Library 

The library's exported procedure, EnumProcessesO, mimics 
the prototypes of other enumeration procedures in Windows. 

BOOL WINAPI EnumProcesses( PTSTR szComputerName, 

UINT uProcessID, PRDCESSENUMPROC ProcessEnunProc, LPARAM lParam ); 

The first parameter names the machine whose processes 
you want to enumerate. Machine names begin with two 


backslashes: WMachineName. (Re¬ 
member, though, that as a C-lan- 
guage literal string that would be 
written 'WWMachineName'.) If the 
name pointer is null, EnumProcessesO 
defaults to the local machine. The 
second parameter, if used, limits the 
enumeration to a single process ID in 
order to retrieve the data for one 
known process without the overhead 
of many callbacks from the DLL. 
ProcessEnumProcO, the third parame¬ 
ter, is a callback procedure with the 
following prototype: 


BOOL CALLBACK \ 

ProcessEnumProc( 

PPROCESSENUMDATA pProcessData, 
LPARAM lParam ) 

pProcessData points to a structure 
defined in enumproc.h, whose fields 
hold the name, ID, base priority, and 
thread count for one process. lParam contains whatever value 
was passed as lParam to EnumProcessesO. Using this parame¬ 
ter, a program can pass signals to its own callback proce¬ 
dure. Here's how a sample client, ShouProcO, calls the library: 

//define ENUM_PROCESSES_ALL 0 

/* print column titles */ 

printf( "%5s%9s%8s %s\n", "PID", "Threads". 

"PriBase”, "Name" ); 

if (!EnumProcesses( NULL, ENUM_PROCESSES_ALL, 
ProcessEnumProc, 0L )) 
printf( "Enumeration fai1ed.\n" ); 

And here is how the callback function handles the data 
received for each process: 

BOOL CALLBACK ProcessEnumProc ( 

PPROCESSENUMDATA pProcessData, 

LPARAM lParam ) 

{ 

TCHAR szOutputLine[FILENAME_MAX * 2]; 

HANDLE hStdOut; 

hStdOut = GetStdHandle( STD_OUTPUT_HANDLE ); 
if (IhStdOut) 
return/ FALSE ); 

wsprintf( szOutputLine, TEXT("%51u%91u%81u %s\n"), 
pProcessData-MDProcess, 
pProcessData->ThreadCount, 
pProcessData-SPriorityBase, 
pProcessData-MnstanceName ); 

WriteConsole( hStdOut, szOutputLine, 

lstrlen(szProcessData), NULL, NULL ); 
return( TRUE ); 

) 

MriteConsoleO works better than pri ntf0 here because, 
depending on the UNICODE setting, pProcessData->InstanceName 


Page 38 — Windows/DOS Developer’s Journal 


April 1994 
























































IMPROVE YOUR 
SOFTWARE ENGINEERING WITH 
OBJECT-ORIENTED METHODS 








OBJECT-ORIENTED 
SOFTWARE 
ENGINEERING 

Steve Halladay & 
Michael Wiebel 


Learn how to: 

C Engineer applications 
to minimize costs 

O Manage all six phases 
of the software lifecycle 

Cllse recursion in the 
object-creation process 









may point to a Unicode string. The printfO in Microsoft's 
C runtime library handles wide-character strings, but not 
everyone's libraries do, so UriteConsoleO is more portable. 


ShowProcO produces a list like this: 


PID 

Threads 

PriBase 

Name 

0 

1 

0 

Idle 

7 

19 

8 

System 

28 

6 

11 

smss 

20 

27 

13 

csrss 

13 

2 

13 

winlogon 

70 

4 

13 

screg 

65 

6 

10 

lsass 

41 

6 

7 

netdde 

84 

2 

13 

progman 

82 

4 

7 

ntvdm 

132 

1 

9 

CMD 

56 

1 

9 

SHOWPROC 


The fact that process names appear in different cases is 
insignificant; the case depends merely on how the process 
name was first typed. The processes with cryptic names 
belong to the system. Here are a few you might see: 

csrss = Client Server Runtime SubSytem (Win32 Subsystem) 
lmsvcs = Lan Manager Services 


lsass = Local Security Authority Subsystem 

psxss = Posix Subsystem 

smss = Session Manager Subsystem 

For the complete code listing, with header, .DEF, and 
make files for both Borland and Microsoft compilers, see 
the Online Source Code box on the table of contents. 

Conclusion 

An EnumThreadsO function would follow almost exactly 
the same steps as EnumProcessesO and call many of the 
same subroutines. Threads have different counters, such 
as 'ID Thread', 'ID Process', 'Thread State', and "Current 
Priority". GetTitlelndicesO would have to find and remem¬ 
ber the index values for thread titles instead of process 
titles. StoreThreadCounterValueO would replace StoreProc- 
essCounterValueO, and, of course, the header file would de¬ 
fine a data structure to hold thread counter values and a 
callback function to receive the structure. 

With the information EnumProcessesO returns you can 
discover and manipulate other processes. Or you can use 
the library code to find your way into the performance 
data for any object the system monitors. You can then 
use the information to make better programming deci¬ 
sions, based on how your code affects the paging file, disk 
operations, the CPU, physical memory, and other system 
resources. □ 
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Last month, I described tear-off menus and presented a demonstration pro¬ 
gram that takes advantage of them, along with some of the low-level functions 
I used to implement them. This article presents the remaining high-level code 
and fills in the details about the implementation. 




A Short Review 

Tear-off menus give the user the ability to pull down a menu and then 'pin' 
it, so that it stays visible on the screen for quick access to its commands. In 
fact, Motif even uses a small pushpin icon to show that a menu has been 
"pinned' or 'torn off' in this fashion. The torn-off menu stays on top of your 
application window until you delete it. I implemented tear-off menus in a DLL, 
tearoff.dll, that makes it easy for you to turn your existing menus into tear-off 
menus just by adding a couple of function calls to your program. 

Figure 1 shows how tear-off menus look to the user. The figure shows the 
user pulling down a menu, clicking with the right button to 'tear off' the menu, 
dragging the menu to a new position, and releasing it. The user can click on 
the tear-off menu's system icon to dismiss it, and the tear-off menu automat¬ 
ically gets destroyed when its parent window goes away. 

As noted last month, the Windows menu manager provides no services to 
implement a "modeless' menu (one that stays visible and allows input to go to 
other windows). To avoid having to reinvent all the code in the menu man¬ 
ager, 1 use a bit of a trick to implement tear-off menus. The trick is this: when 
the user tears off a menu by depressing the right mouse button, I snap a copy 
of the menu into a bitmap, which I then display in a topmost window (the 
tear-off menu window). To the user, the window appears to contain a valid 
menu, but it is really just a passive bitmap image. When the user uses the 
mouse to select an item in the tear-off menu window, I arrange to call Track- 
PopupMenuO and have it display the real menu directly over the bitmap image; 
the Windows menu manager still does all the hard work, but the user is fooled 
into believing that the bitmapped image is a real menu. 

tearoff. c (Listing 1) contains the high-level functions that were not presented 
in last month's code listings. Table 1 displays the TOS (Tear-Off State) structure, 
which is the primary data structure that tearoff.dll uses. The code manages a 
linked list of TOS structures, each of which corresponds to a tear-off menu on 
the screen. Before examining the code in detail, I will describe the message 
flow that tear-off menus depend on. 
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Table 1 Members of TOS (Tear-Off State) structure 

grftos 

a group of flags that describe various modes the tear-off menu can be in: 

ftosTearMenu indicates that an actual menu is present on top of the 
tear-off menu window. 

ftosActive controls whether the tear-off menu window caption is 

drawn as active or inactive. 

ftosHilite TRUE when user has depressed mouse button over tear- 

off menu window system icon, and mouse is still over 
the system icon (so it should be highlighted). 

ftosDrag TRUE while user is dragging a tear-off menu window. 

ftosOn TRUE while ghost frame (used during dragging) is visible 

(must be XOR-ed again to move or erase it) 

Pt 

last location of mouse during dragging. 

dpt 

offset of the original mouse position when dragging began. 

szTitle 

text of the tear-off menu window caption (a variable-length field). 


the message to FilterTearOffO (see 
Listing 1), the main function you call 
to turn your menus into tear-off 
menus. 

The UM_RBUTT0ND0UN message sent 
to FilterTearOffO starts the process 
of tearing off the menu, but this mes¬ 
sage alone does not contain enough 
information to allow me to create a 
tear-off menu window. I need the 
handle of the popup menu that was 
under the mouse button, so that I 
can display the same menu later by 
calling TrackPopupMenuO. In addition, 
as described last month and shown 
in Figure 1, I try to set the caption of 
the tear-off menu window equal to 
the text of the menu item the user 
selected to pull down the menu. 
That information is also not avail- 


Tear-off Message Flow 

The user depresses the right (or 'secondary' if you are 
left-handed and have reversed the meanings) mouse but¬ 
ton to tear off a standard pulldown (or popup) menu. A 
UM_RBUTT0ND0UN message is sent to the window that owns 
the menu, and that window's window procedure passes 
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able at the time the UM_RBUTT0ND0UN 

message arrives. 

The solution is to collect information about the menu 
that is being displayed at some point before the UM_RBUT- 
TONDOUN message arrives. The best place to gather this in¬ 
formation is at the UMJNITMENUPOPUP message. So, when 
FilterTearOffO receives a UMJNITMENUPOPUP, it allocates a 
TOS structure from the DLL's local heap to represent the 
potential tear-off menu; FilterTearOffO also stores the the 
popup menu handle and tear-off title text in the newly 
allocated TOS structure. This is all in the hopes that the 
user later will click the right mouse button and create a 
tear-off menu. 

After the UMJNITMENUPOPUP case in FilterTearOffO allo¬ 
cates and initializes a fresh TOS structure, it has to store a 
pointer to the structure somewhere where it can be re¬ 
trieved when future window messages arrive. I chose to 
temporarily attach it to the window owning the menu (the 
one calling FilterTearOffO) by using a window property 
(SetPropO). The nice thing about SetPropO is that you can 
attach data to arbitrary windows with it. Because menu 
mode is modal and not reentrant, there is no danger that 
the FilterTearOffO will try to store more than one TOS 
pointer in the same window property. 

The first thing the UMJNITMENUPOPUP code does is remove 
and free any TOS pointer attached to the window from a 
previously popped menu that was not torn off. The code 
uses the macro PtosRemveUndO, a RemovePropO wrapper 
that removes the 16-bit value associated with the string 
"MenuTag" from the owner window. Window properties 
must be explicitly freed to avoid a resource leak. Re¬ 
movePropO will return NULL if no such property exists. The 
code calls FreeTosO on the result; FreeTosO checks to see 
if the pointer passed to it is NULL If not, FreeTosO will free 
the bitmap if there is one, and then free the TOS structure. 

The UMJNITMENUPOPUP code next checks the high 16 bits 
of IParam, which will be nonzero if the menu is the system 
menu. The code simply returns if the system menu is be¬ 
ing popped up. This prevents the user from being able to 
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tear off the system menu. If you want to allow the user to 
do this, remove the check. 

The next bit of code walks the linked list of TOS s and 
does a couple of things. First, it checks to see if the menu 
being activated already has a corresponding tear-off 
menu. It does this by comparing the current TOSs menu 
handle ( hmnil) member with the menu handle of the popup 
being activated (in wPararrt). If it finds a match, then a tear- 
off for that menu currently exists. The code next checks to 
see if the ftosTearMenu flag is set. If so, it means the user 
has clicked on a tear-off and TrackPopupMenuO has been 
called to display a real menu on top of the tear-off. If this 
is the case, then the UMJNITMENUPOPUP code immediately re¬ 
turns, since the tear-off already has ail the information it 
needs. 

If ftosTearMenu is not set, then the user is clicking on the 
parent menu item associated with the tear-offs popup 
menu. The code responds by calling DestroyUindowO to 
nuke the tear-off to prevent multiple tear-offs from being 
created (which would only confuse the user). To the user, 
it looks like the existing tear-off jumps back to its original 
popup menu form. The code next obtains the caption text 
for the tear-off want-to-be, by calling the function 
HmnuFindO, which 1 described last month. 

The last thing the UMJNITMENUPOPUP code does is to actu¬ 
ally allocate a new TOS and store the popup menu handle, 
owner window, and caption text in it. It then attaches the 
TOS pointer to the owner window using the macro 
FSetUndPtosO, which is a wrapper around the SetPropO 
routine. If SetPropO fails, the code gives up and frees the 
TOS structure. 

As mentioned last month, if the menu succeeds in pop¬ 
ping up (it may fail because of an out-of-memory condi¬ 
tion), the menu's owner window receives a UMJNTERIDLE 
message immediately after the menu window becomes 
visible. FilterTearOffO has code for this message, to en¬ 
able it to remove the TOS pointer from the menu's owner 
window and re-attach it to the popped up menu window. 
This is necessary because if a popup possesses submenus, 
it is possible to have a cascade of menus present at any 
given time. But tearoff.dll cannot know in advance which 
menu the user will pick with the right mouse button. By 
the time the UM_RBUTT0ND0UN message is received, there is 
no information available about the popup menu under 
the mouse. By associating a TOS pointer with the actual 
menu window, the code that handles the UM_RBUTT0ND0UN 
message can obtain the information gathered earlier in 
the UMJNITMENUPOPUP message. 

I can hear some of you thinking Aha! But why not just 
keep track of the most recent TOS gathered in the UMJNIT¬ 
MENUPOPUP message, and use that when the UM_RBUTT0ND0UN 
message is received, since the data will correspond to the 
most recently popped-up menu?" The problem is that a 
user can cancel the most recently popped-up menu by 
pressing the Escape key. If the user then right-clicks on the 
previous submenu, the code will be using data for the 
wrong menu. The menu manager does not resend the 
UMJNITMENUPOPUP menu to the parent of a canceled sub¬ 
menu. 


Returning to the message handling code, since UMJN- 
TERIDLE messages are also sent by dialog boxes, the code 
for this case checks if the value of wParam is MSGF_MENU, and 
returns if it is not. As a sanity check, it next obtains the 
window handle of the topmost popped-up menu, and re¬ 
turns if there is none. The code accomplishes this feat 
with the magical HwndMenuCurO macro. The macro is simply 
a wrapper around a call to FindUindowO. FindUindowO ac¬ 
cepts a class name string and a window title string, either 
of which may be null. HwndMenuCurO passes FindUindowO 
the class string "#32768" (the menu window class name) 
and null for the title string. The reason this all works is 
twofold: FindUindowO always returns the first window 
matching its criteria, and the window z order is inferred 
from the order of sibling windows. Menu windows are sib¬ 
lings of each other, so the first menu window found is 
always the topmost one. 

Assuming the previous two checks succeed, the UMJN- 
TERIDLE code then calls the macro PtosRemveUndO to de¬ 
tach the TOS pointer from the owner window. This pointer 
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Listing 1 tearoff.c — Automatic tear-off menu code 


/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★Hr*****/ 

#endif 

/* tearoff.c */ 

int CALLBACK export WEP(int wExitCode) 

/* -- Module implements tear-off menus. */ 

{ 

/★★★★★★★★★★★★★★★★★★★★★★★★★★Hr**************************/ 

if (NULL 1= hdcMem) 

^include "tearutil.h" 

DeleteDC(hdcMem); 
if (NULL 1= hbmpSys) 

const char szMenuClass[] = "#32768"; 

DeleteObject(hbmpSys ); 

const char szTearClass[] = "TearOffPopup"; 

if ( IsWindow(hwndMainMenu)) 

const char szMenuTagt] * "MenuTag"; 

FreeTos(PtosRemoveWnd(hwndMainMenu)); 
return 1; 

HMND hwndMainMenu; /* USER’S reusable menu wnd. */ 

} 

PTOS ptosHead; /* Head of TOS linked list. */ 


WNDPROC lpfnMenu; /* USER’S menu window proc. */ 

void WINAPI _export FiIterTearOff(HWND hwnd, UINT wm, 

UINT wmPrivate; /* Our private windows msg. */ 

WPARAM wParam, LPARAM IParam) 

int dyText; /* System font height. */ 

j ★★★*★*****★★★★*★★★★★★★★★★★*★*★**★★★★*★★***★★★★**★*★** i 

HBITMAP hbmpSys; /* Small system-menu icon. */ 

I* -- Callback filters messages from the owner */ 

BITMAP bmpSys ; /* Metrics of icon. */ 

/* window needed by the tear-off module. */ 

HDC hdcMem; /* Memory DC. */ 

/★★It**************************************************/ 

{ 

char szMenu[256]; 

#ifdef BORLANDC 

#pragma argsused 

HWND hwndT; 

#endif 

PTOS ptos, ptosNext; 

int CALLBACK LibMainCHINSTANCE hins, WORD ds. 

int cch; 

WORD cbHeap, LPSTR lpsz) 

HMENU hmnu; 

I*****************************************************/ 


/* -- Initialize the tear-off menu module. */ 

/* The wmPrivate message has 2 meanings. When */ 

I*****************************************************/ 

/* IParam is non-null, it contains the popup */ 

{ 

/* menu data for a new tear-off. When non-null */ 

WNOCLASS wcs; 

/* it means USER attempted to activate a */ 

/* tear-off window, which is disallowed. */ 

wcs.style = CS GLOBALCLASS; /* Register the tear-*/ 

if (wm == wmPrivate) 

wcs.lpfnWndProc = LwTearProc; /* off class. */ 

{ 

wcs.cbClsExtra = 0; 

if (0 != IParam) 

wcs.cbWndExtra * sizeof(PTOS); 

{ /* Create a new tear-off. */ 

wcs.hlnstance = hins; 

ptos = (PTOS)LOWORD(lParam); 

wcs.hlcon = NULL; 

if (NULL != CreateWindowtszTearClass, 

wcs.hCursor = LoadCursoriNULL, IDC ARROW); 

ptos->szTitle, WS POPUP, 0, 0, 0. 0, 

wcs.hbrBackground = (HBRUSHKCOLOR WINDOW + 1); 

hwnd, NULL, GetWindowlnstance(hwnd), 

wcs.lpszMenuName = NULL; 

(LPVOID)lParam)) 

wcs.lpszClassName = szTearClass; 

EndSnap(ptos, (HWND)wParam, TRUE, dyText, hdcMem); 

if (I RegisterClass(&wcs)) 

else 

return FALSE; 

FreeTos(ptos); 

} 

else /* Activate owner window. */ 

/* Use a private message for dropping tear-off */ 

/* menus, since the owner window will see this */ 

SetActiveWindow(hwnd ); 

/* message. */ 

} 

wmPrivate = RegisterWindowMessageCszTearClass ); 

else switch (wm) 

if (NULL == wmPrivate) 

{ 

return FALSE; 

default: 

break; 

/* Find resuable menu window. */ 


if ((GetSystemDebugStateO & $DS_MENU) II 

case WM_NCACTIVATE : /* (De)activate tear-offs. */ 

NULL == ( hwndMai nMenu = HwndMenuCurO)) 

for (ptos = ptosHead; NULL != ptos; 

return FALSE; 

ptos = ptos->ptosNext) 

lpfnMenu = (WNDPROC) 

if (hwnd ~ ptos->hwndOwner) 

GetWindowLong ( hwndMainMenu, GWL_WNDPROC ); 

{ 

if (0 ** wParam) 

/* System icon. */ 

ptos->grftos &= -ftosActive; 

if (NULL == (hbmpSys = LoadBitmap(NULL, 

else 

MAKEINTRESOURCEtOBM CLOSE)))) 

ptos->grftos |= ftosActive; 

return FALSE; 

InvalidateRect(ptos->hwnd, NULL, FALSE); 

GetObjectthbmpSys, sizeof bmpSys, SbmpSys); 

UpdateWindow(ptos->hwnd); 

bmpSys.bmWidth /= 2; /* Use second half. */ 

} 

break; 

/* Need a memory DC for blits. */ 


if (NULL == (hdcMem = CreateCompatibleDC(NULL))) 

case WM_INITMENUPOPUP: 

return FALSE; 

FreeTostPtos RemoveWnd(hwnd)); 
if (HIWORD(lParam)) 

/* Text height. */ 

break; /* System menu. */ 

dyText = HIWORD(GetDialogBaseUnitsO); 


return TRUE; 

/* If a tear-off for this menu exists, */ 

) 

/* destroy it unless its a tear-off's */ 

/* menu that is being activated. */ 

tfifdef _BORLANDC_ 

for (ptos = ptosHead; NULL 1= ptos; 

tfpragma argsused 
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may be NULL, since NM_ENTERIDLE will be received twice 
when a popup menu is displayed (once following the 
UM_ INI TMENUPOPUP message and once following the 
UM_MENUSELECT message). If the 70S pointer has already been 
removed, the code checks the state of the right mouse 
button. If it is still down, the code gets the position of the 
mouse and jumps to the UM_RBUTT0ND0UN case. This code is 
used to detect a right mouse click during menu mode, and 
to begin the tear-off process if one is detected. This round¬ 
about way of detection is required because the menu 
manager will not dispatch right-button messages that ap¬ 
pear in its loop to the menu owner. The code takes ad¬ 
vantage of the fact that every time the menu mode loop 
removes a message from the queue, it posts a UM_EN- 
TERIDLE message to the menu's owner window. If the right 
mouse button is not down, the code returns, since the TOS 
pointer has already been removed from the owner win¬ 
dow and attached to a normal Windows menu window. 

If the UM_ENTERIDLE code does succeed in removing a TOS 
pointer attached to the owner window, it then attempts to 
attach it to the normal Windows menu window. If all goes 
well, the code then checks to see if the current menu win¬ 
dow is transient (i.e., if it is not the permanent, reusable 
one) and subclasses it if so. This is necessary so that the 
subclass procedure, LuSubclassProcO, can remove the 
'MenuTag' property that contains the TOS pointer to the 
window. It is okay to subclass these transient menu win¬ 
dows, since the subclass procedure will exist the entire 
lifetime of the menu window. If some other task does 


Listing 1 continued 


ptos = ptos->ptosNext) 
if ((HMENU)wParam == ptos->hmnu) 

{ 

if (pto$->grftos & ftosTearMenu) 

{ 

ptos->grftos 4= -ftosTearMenu; 
return; 

} 

DestroyWindow(ptos->hwnd); 
break; 

} 

/* Get menu title from parent menu. */ 
cch = 0; 

if (NULL != (hmnu = HmnuFind(GetMenu(hwnd), 
(HMENU)wParam, LOWORDt1 Pa ram)))) 
cch = GetMenuString(hmnu, LOWORDC1Param). 
szMenu, sizeof szMenu, MFJYPOSITION); 

/* Gather up menu info. */ 
if (NULL == (ptos = PtosAlloc(cch))) 
break; 

ptos->hmnu = (HMENU)wParam; 
ptos->hwndOwner = hwnd; 
if (0 != cch) 

1strcpy(ptos->szTitle, szMenu); 

/* Temporarily save menu data with owner. */ 
if UFSetWndPtosthwnd, ptos)) 

FreeTos(ptos); /* All that work for zip. */ 
break; 

case WMJNTERIDLE: 

if (MSGF_MENU 1= wParam II 


[ Hands-On Windows and C++ Training ] 


April: MFC and OWL 2.0 Courses 


C++ and Windows in a Week 
We teach experienced C program¬ 
mers the basics of C++ in two days, 
then add three days of Windows 
programming using a C++ class 
library. We take you from square 
one through construction of a 
complete Windows applica- 
tion.There are two versions: Visual 
C++ with the Microsoft Founda¬ 
tion Classes and Borland's 
ObjectWindows. 

C++ as a "Second Language" 

For programmers who have 
worked in languages other than C. 
The complete C++ language, with 


object-oriented analysis and design 
concepts. Four days. Generic C++, 
not specific to Windows or DOS. 

Visual Basic 

Four days of Microsoft Visual Basic 
programming in Windows: the environ¬ 
ments of VB and Windows, the VB 
tools and how to use them, Windows 
application design, tire VB language, 
using tire Windows API and DLLs, 
debugging. 

Advanced Visual Basic 

Three days. For current users of VB 
who want to explore DDE, OLE, user- 
defined types, customizing standard 
controls, using the VB database engine. 


Call Today To Register. 
Start building Windows 
Applications NOW! 


1-800-388-3535 

In MD call (301)230-1840 


Upcoming public courses 

C++/Win in a Week April 11-15 
(Microsoft Visual C++, MFC) 

C++ 2nd Language April 18-21 
C++/Win in a Week April 25-29 

(Borland BCPP 4.0 & OWL 2.0) 

Washington, DC area 

Call now to register! 

Experience Counts! 

&msg has taught C++ and Windows since 
1989. We have been working Windows 
developers since version 2.0. Put our 
expertise to work for you. All courses 
available for onsite presentation, including 
customization. 

&msg 

Messaging Systems Group, Inc. 

1559 Rockville Pike, Suite 250 
Rockville, MD 20852 _ j 


April 1994 


□ Request 261 on Reader Service Card □ 


Windows/DOS Developer’s Journal — Page 45 





















Listing 1 continued 


NULL == ( hwndT = HwndMenuCurO)) 

PTOS ptosT, *pptos; 

break; 

PAINTSTRUCT wps; 

if (NULL == (ptos = PtosRemoveWnd(hwnd) )) 

RECT rect; 

POINT pt; 

{ 

HWND hwndT; 

if (GetKeyStatetVK RBUTTON) < 0) 

HBRUSH hbrs, hbrsSav; 

{ 

HBITMAP hbmpSav; 

GetCursorPost(LPPOINT)SlParam); 
goto LRButtonDown; 

if (wm == wmPrivate) 

) 

/* Then finish UpdateTearOffst) ' work. */ 

break; 

EndSnapt(PTOS)L0W0RD( 1 Param), (HWND)wParam, 

} 

FALSE, dyText, hdcMem); 

/* Transfer info to USER menu window and */ 

else switch (wm) 

{ 

/* subclass transient popup’s to remove */ 

default: 

/* window property. */ 

break; 

if ( FSetWndPtos ( hwndT, ptos)) 

{ 

case WM MOUSEACTIVATE: /* Ditto. */ 

if (hwndMainMenu != hwndT) 

SetActiveWindow(ptos->hwndOwner ) ; 

SubclassMindow(hwndT, LwSubclassProc); 

} 

else 

return MAJOACTIVATE; 

case WM ACTIVATE: /* Give it back to owner. */ 

FreeTos(ptos); 

PostMessage(ptos->hwndOwner, wmPrivate, 0, 0); 

break; 

return 0; 

case WM RBUTTONDOWN: 

case WM CREATE: 

LRButtonDown: 

ptos = (PT0S)L0W0RD( (( LPCREATESTRUCT) 1 Param) - > 

if ( WindowFromPoint (*( POINT *)&1 Param) == 

IpCreateParams); 

(hwndT = HwndMenuCurO) && 

ptos->hwnd = hwnd; 

NULL != (ptos = PtosRemoveWnd(hwndT))) 

ptos->grftos = ftosActive; 

BeginSnap(ptos, hwnd. hwndT, wmPrivate); 

ptos->ptosNext = ptosHead; /* Link in list. */ 

break; 

ptosHead = ptos; 

case WM DESTROY: 

SetWindowWord(hwnd, 0, (WORD)ptos); 

SendMessage(ptos->hwndOwner, wmTearOffCreate, 

F reeTos ( Ptos RemoveWnd ( hwnd )); 

(WPARAM)hwnd, MAKELONGCptos->hmnu, 0)); 

for (ptos = ptosHead; NULL != ptos; /* Nuke */ 

break; 

ptos = ptosNext) /* all associated tear- */ 

{ 

case WM PAINT: 

ptosNext = ptos->ptosNext; 

BeginPaint(hwnd, &wps ) ; 

if (hwnd == ptos->hwndOwner) /* offs. */ 

PaintSysIcontptos, wps.hdc, hdcMem, hbmpSys, dyText, bmpSys); 

DestroyWindow(ptos->hwnd); 

} 

break; 

GetClientRect(hwnd, &rect); 

/* Paint caption background. */ 

} 

hbrsSav = NULL; 

} 

if (NULL != (hbrs = CreateSolidBrush( 

void FreeTos(PTO$ ptos) 

GetSysColor((ptos->grftos & ftosActive) ? 

COLOR ACTIVECAPTION ; 

j*****************************************************j 

CO LO R_I NACT IV ECAPTI ON )))) 

/* -- Clean up stuff hanging off node and free it. */ 

hbrsSav = SelectObjecttwps.hdc, hbrs); 

/*****************************************************/ 

Rectangle(wps.hdc, dyText, 0, rect.right. 

{ 

dyText + 1); 

if (NULL == ptos) 

if (NULL != hbrsSav) 

return; 

SelectObjecttwps.hdc, hbrsSav); 

if (NULL != ptos->hbmp) 

if (NULL != hbrs) 

DeleteObj ect ( ptos->hbmp ); 

DeleteObject(hbrs ); 

LocalFree((HLOCAL)ptos ); 

} 

/* Paint caption text. */ 

LRESULT CALLBACK export LwSubclassProc(HWND hwnd, 

SetBkMode(wps.hdc, TRANSPARENT); /* Text. */ 

UINT wm, WPARAM wParam, LPARAM 1Param) 

SetTextColortwps.hdc, GetSysColor( 

/*****************************************************/ 

(ptos->grftos & ftosActive) ? 

/* -- Popup menu window subclass procedure. */ 

COLOR CAPTIONTEXT : 

/********★**************************************★*****/ 

COLOR INACTIVECAPTIONTEXT)); 

{ 

rect.left += dyText + 1; 

if (wm == WM DESTROY) 

DrawTexttwps.hdc, ptos->szTitle, -1, Srect, 

FreeT os ( PtosRemoveWnd ( hwnd )); 

DT_CENTER I DT_SINGLELINE I DT_T0P); 

return CallWindowProcdpfnMenu, hwnd, wm, wParam, 

1Param); 

/* Paint menu image. */ 

} 

hbmpSav = SelectObjectthdcMem, ptos->hbmp); 

LRESULT CALLBACK export LwTearProctHWND hwnd. 

BitBlttwps.hdc, 0, dyText, rect.right, 

UINT wm, WPARAM wParam, LPARAM IParam) 

rect.bottom, hdcMem, 0, 0, SRCCOPY); 

/★**★★*★★★**★★★*★****★*************★***★*****★★****■*•*★/ 

if (NULL != hbmpSav) 

/* -- Tearoff window procedure. */ 

SelectObjectthdcMem, hbmpSav); 

{ 

PTOS ptos = ( PTOS)GetWindowWord(hwnd, 0); 

EndPaint(hwnd, &wps ); 

/* If we somehow got a paint during a drag, */ 
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somehow manage to subclass the same window, the 
worst that will happen is that my subclass procedure will 
not see the UM_DESTROY and the property resource will be 
lost. If the TOS pointer could not be attached to the menu 
window, the code frees the TOS struct. 

The real excitement begins upon receipt of the UM_RBUT- 
TONDOUN message (or a jump from the right button down 
detection code in the previous UM_ENTERIDLE message case). 
The code for this case checks if the window under the 
mouse is the topmost menu window; if so it removes the 
TOS pointer from the window. If the pointer is not NULL, the 
code calls the helper routine BeginSnapO to initiate the 
tear-off process. As described in detail last month, Begin¬ 
SnapO does a little magic to deselect any selected menu 
item, and then it posts a mPrivate message that delivers 
the handle of the window enclosing the current menu to 
the window that owns the menu. 

When FilterTearOffO receives the mPrivate message 
that BeginSnapO posted, it is finally ready to create a win¬ 
dow to contain the tear-off menu. FilterTearOffO obtains 
the TOS pointer from IParam and passes it via lpvParam to 
CreateUindowO. The tear-off's window procedure, LwTear- 
ProcO, then extracts the TOS pointer from the CREATESTRUCT 
it receives with the UM_CREATE message. The UM_CREATE code 
fills in some more TOS members, sets the ftosActive flag in 
the grftos member so that the window will draw itself as 
active, inserts its TOS into the linked list, and stores the TOS 
pointer in the tear-off window's extra window word. All 
other messages handled by LwTearProcO use the TOS 


Listing 1 continued 


/* restore the ghost frame. */ 
if <(ptos->grftos & (ftosDrag I ftosOn)) == 
(ftosDrag I ftosOn)) 

DrawGhost(ptos); 
return 0; 

case WM_ERASEBKGND: /* Who needs it?! */ 
return TRUE; 

case WM_DESTROY: /* Clean up, inform owner. */ 
SendMessage(ptos->hwndOwner, wmTearOffDestroy, 
(WPARAH)hwnd, MAKELONGiptos->hmnu, 0)); 
for (pptos = JptosHead; /* Unlink from list. */ 
NULL ! = *pptos; pptos = &{*pptos)->ptosNext) 
if (*pptos == ptos) 

{ 

*pptos = ptos->ptosNext; 
break; 

} 

FreeTos(ptos); 
break; 

case WM_LBUTT0ND0WN: /* Enter drag mode, track */ 

case WM_RBUTT0ND0WN: /* icon, or activate menu. */ 
/* Bring to top without activating. */ 
SetWindowPosthwnd, HWND_T0P, 0, 0, 0, 0, 
SWPJOACTIVATE I SWPJOSIZE I SWPJOMOVE); 
pt = ‘(POINT *)&TParam; 
if (pt.y < dyText I| wm == WM_RBUTT0ND0WN) 

{ /* Hit inside caption area. */ 
if (pt.x >= dyText 11 wm == WMJBUTTONDOWN) 
{ /* Hit outside system icon. */ 

/* Update all tear-offs first. */ 
for (ptosT = ptosHead; NULL != ptosT; 
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Listing 1 continued 


ptosT = ptosT->ptosNext) 
UpdateWindow(ptosT->hwnd); 
ptos->dpt = pt; /* Drag offset. */ 
ClientToScreen(hwnd, &pt): 
ptos->pt = pt; /* Current position. */ 
ptos->grftos 1= ftosDrag; 
ptos->grftos &= -ftosOn; /* frame. */ 
DrawGhost(ptos); /* Display ghost */ 

} 

else 

{ /* Hit inside system icon. */ 
ptos->grftos 1= ftosHilite; 

PaintSysIcon(ptos, NULL, hdcMem, hbmpSys, 

dyText, bmpSys); 

} 

SetCapture(hwnd); 

} 

else 

{ /* Drop the real menu. */ 
pt.x = 0; 
pt.y = dyText; 

ClientToScreenthwnd, &pt); 
ptos->grftos |= ftosTearMenu; 
TrackPopupMenu(ptos->hmnu, 

TPM.LEFTALIGN I TPM_LEFTBUTTON, pt.x. 
pt.y, 0, ptos->hwndOwner, NULL); 

} 

break; 

case WM_M0USEM0VE: 

if (GetCaptureO != hwnd) 
break; 

pt = ‘(POINT *)&1Param; 
if (ptos->grftos & ftosDrag) 


pointer extracted from the extra window word at the top 
of the routine. 

The UM_CREATE code in LwTearProcO also informs the 
owner window that a new tear-off has been created by 
sending a wmTearOffCreate message. Along with the mes¬ 
sage, LwTearProcO passes the popup menu handle and the 
tear-offs window handle. This allows the owner window 
to manipulate tear-off windows (such as repositioning or 
destroying them), giving you an extra degree of control 
over tear-off menus without having to change any 
tearoff.dll source code. 

After LwTearProcO returns from the UM_CREATE message, 
control eventually returns to the wmPrivate code in Fil- 
terTearOffO. If the tear-off window could not be created, 
CreateUindowO will return NULL and the TOS will be freed. If 
a window was successfully created, the helper procedure 
EndSnapO (described last month) is called to complete in¬ 
itialization of the tear-off menu. 

The UM_PAINT case in LwTearProcO has four main respon¬ 
sibilities. It paints the little system icon, paints the caption 
background, draws the caption text, and blits the offscreen 
menu image to the screen. After PaintSysIconO (described 
last month) returns to the UM_PAINT case of LwTearProcO, 
the grftos member is checked to see if the ftosActive flag 
is set. If it is, the system's current active caption color is 
used to create a brush; otherwise, the inactive caption 
color is used. The brush is then used in a call to Rectan- 
gleO to frame the rest of the caption. The check for 
ftosActive is also used in determining the color to use for 
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products). Wildcard and list-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Mainframe-compatible delta generator for Pansophic, 
ADR, IBM, Sperry formats. Integrated with industry-leading MAKE 
from Opus™ software. 


MS-DOS $139, OS/2 & NT (with MS-DOS) $195 + shipping. 

5-user net: DOS $419, OS/2+NT+DOS $595. Call for other sizes. 
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Peer to Peer LAN, to 250 nodes 
$75 total software cost! 

No matter how many nodes! 

Use Ethernet, Arcnet or 

serial/parallel/modem to connect. 


Mixed mode routing 

My combination of above connection is possible 
on any given node. 

Use with windows 

Seen as 100% compatible 

Microsoft Network EyHjVXTXT 

by Windows 3.x. ■ HUli/Alt 


Information Modes 

P.O. Drawer F 
Denton TX 76202 
817-387-3339 Techline 
817-382-7407 Fax 

1-800-628-7992 Orders 


Lillie Big Lon 


The $25 Network 


Try the 1st truly low cost LAN 

• Connect 2 or 3 PCs, XTs, ATs, PS/2s 

• Uses seriaf ports and 5 wire cable 

• Puns at USK baud, up to 90 feet 

• Transfer S500 bytes per second (ATs) 

• Runs in background, totally transparent 

• Share any device, any file, any time 

• Needs only I5K of ram 

• Just $25 per network, NOT PER NODE! 

• Replace aH fife transfer software 

• Version 2.3P now has TinyMAfL 

• OVER 20,000 SOLD WORLDWIDE 

Skeptical? We make believers! 
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the caption text. After the appropriate color is set as the 
text color, DrauTextO is called to output the caption text. 
This is a very handy routine to use in this case, since it 
will treat a single occurrence of the ampersand character 
as an escape to underline the next character, just like the 
text that appears in a menu item (this is no coincidence, 
DrauTextO is also used by the menu manager to display its 
strings). Following the call to BitBltO to display the menu 
image, the tear-off is completely painted. 

The last bit of code in the UM_PAINT case handles the 
previously mentioned possibility that a tear-off being 
dragged might receive a paint message. If the ghost frame 
was visible before the message was received, the ftosOn 
flag will be set, which causes the code to call DrauGhostO 
to restore the frame. 

Bells and Whistles 

LibMainO' s first task is the utilitarian chore of registering 
a class for tear-off windows. Since the calling module is a 
DLL, the CS_GLOBALCLASS style is required, so tearoff.dll can 
create tear-off windows on behalf of client modules. Lib¬ 
MainO also obtains the wmPrivate message from Register- 
MindouMessageO; I just got lazy here and reused the class 
name string for the message string. The code then uses 
the HundMenuCurO macro to find Windows' reusable menu 
window. 

It is remotely conceivable that a client application could 
be launched from within another application's menu loop, 
in which case a transient menu window could be present 
(if the other application was currently showing some 
popup's submenu). While this is highly unlikely (it would 
require a really twisted application to MinExecO another 
application from menu mode), it is possible. In this case, 
HundMenuCurO' s call to FindUindouO would return the tran¬ 
sient popup. My somewhat cheesy solution is to call Get- 
SystemDebugStateO and check for the bit SDSJtENU in the re¬ 
turn value. If SDS_MENU is set, then some other application is 
indeed in menu mode, and my code just returns. If you 
really care about this you could write a loop to enumerate 
all the windows of class '#32768' and use the last such 
one found (since Windows' reusable window will be the 
first one shown and therefore bottommost). By the way, 
GetSystemDebugStateO is available in both debug and retail 
versions of Windows 3.1. 

LibMainO continues on and loads the bitmap containing 
the system menu icons. This bitmap contains a standard 
system menu icon followed horizontally by a small system 
menu icon (the kind seen in MDI windows). I got the di¬ 
mensions of the bitmap with a call to GetObjectO, and 
then I just divide the width by 2, since I will only be using 
the second half of the bitmap. The code then allocates a 
memory display context for the lifetime of the DLL (to use 
as the source for BitBltOs) and obtains the height of the 
system font. 

The corresponding cleanup code in the WEP is straight¬ 
forward. It frees the memory display context if one was 
successfully allocated, frees the system menu bitmap if it 
got loaded, and if there is a TOS attached to Windows' 
reusable menu window, removes and frees it. 


TCP/IP for Windows 



More Windows applications than any other 
TCP/IP package 

Implemented as 100% Windows DLL (not a TSR) 
Requires only 6KB of base memory 
Installs in 5 minutes 

■ Works concurrently with NetWare, LAN Manager, 
Vines, Windows for Workgroups, etc. 

■ Up to 128 simultaneous sessions 

Applications: 

TELNET (VT100,VT220, TVI),TN3270, TN5250, FTP, TFTP, SMTP 
Mail with MIME, PROFS Mail, News Reader, LPR/LPD, PING, Bind, 
Finger, Whois, Gopher, Phonetag, Scripting, Statistics, Custom, 
SNMP Agent 

Developer Tools: 

Windows Socket API, Berkeley 4.3 Socket API, 

ONC RPC/XDR, WinSNMP API 

Extensible SNMP Agent 

■ Includes MIBII, Workstation,Windows and 
DOS agents 

■ Dynamic registration of multipleagents, managers, 
and proxies 

■ WinSNMP API developers kit available 

■ Compatible with any SNMP manager 

■ Free with Chameleon, and ChameleomVFS 

NFS Client/Server 

■ Network drives are mounted from within Windows 

■ Network printing in the background 

■ Up to 24 network drives 

■ Requires only 6KB of base memory 

■ Included in Chameleon/VFS 

For overnight delivery call: 

B§ Net Manage™ 

( 408 ) 973-7171 


20823 Stevens Creek Blvd., Cupertino, CA 95014 USA 
Fax (408) 257-6405 
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There is a problem with activation that FilterTearOffO 
has to solve. 1 implemented tear-off windows as popup 
windows so that they could be moved outside of their 
owner window. Popup windows have another desirable 
property, in that they are automatically hidden when their 
owner is iconized and restored when their owner is re¬ 
stored. The big problem with popups is that Windows is 
determined to activate them when they are clicked on. 
This is a bad thing, because I don't want tear-off windows 
to steal the focus from the client window. For example, 
assume the client window contains a multiline edit control. 
The user is happily typing away, decides to tear off the 
edit menu, and continues typing, only to see that no char¬ 
acters are appearing in the edit control because the tear- 
off menu window has the input fo¬ 
cus. 

At first I thought I could deal with 
this problem by reactivating the 
owner window after the user finished 
interacting with the tear-off. But then 
the user would see the main win¬ 
dow's caption change from active to 
inactive, which would be disconcert¬ 
ing and distracting. So then I tried 
manipulating UM_NCACTIVATE messages 
between a client window and all of 
its tear-off menu windows, but this 
resulted in a lot of really ugly code. 
In fact, every time I attempted an¬ 
other kludge to work around this 
problem, it just introduced new prob¬ 
lems. After beating my head against 
a wall for a while, I saw that I would 
have to bite the bullet and never al¬ 
low tear-offs to become active. While 
this decision did not affect the behav¬ 
ior of popup menus displayed with 
TrackPopupMenuO, it did preclude rely¬ 
ing on Windows to drag the tear-offs 
for me. 

I had thought I could save some 
code and return HITCAPTION when 
LuTearProcO received a UMJCHITTEST 
in its caption area. This causes Win¬ 
dows to enter a modal drag loop, but 
Windows will first activate the win¬ 
dow. So not only did I have to han¬ 
dle rendering the tear-offs as active 
or inactive, depending on the state of 
their owners, I also had to implement 
my own code to drag them around. 
Luckily, it turned out to be not that 
much code, and I think the benefits 
outweigh the cost. 

So, when LwTearProcO receives a 
UHJCACTIVATE message, it enumerates 
through the list of tear-off menu win¬ 
dows. Each time it finds one whose 
owner is the window receiving the 
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Searching for Regular 
Expressions with less [* A $? 

CyberEDU Delivers 


The ultimate Windows editor for programmers who need 
POWER, EXTENDIB1LITY, SPEED and the SCOPE to 
handle complex software projects. 

Regular expressions are an indispensable editing tool for searching text and 
m making changes to source files. But, the symbols usually used in regular 
expressions are often the same symbols you need to find in your source code. 
This used to mean that you had to use a cumbersome escape character when 
searching for a *, or a [. Now CyberEDIT offers a feature unique in 
programmer's editors. You can change the regular expression symbols to any 
string you wish. Use [[ instead of [, and (*) instead of *. Regular expressions 
stay out of the way until you need them. 

One of CyberEDIT's most powerful enhancements is Total Recall. Each time 
m you save a file, your editing changes are stored in a version history. You can 
browse through all past versions of a file and restore a previous version. If 
you've ever changed a file and then just wished you could get back to that last 
working version, then this feature is for you. 
ygg Built-in C language compiler gives you the tools to add any feature you need as 
SH an editor extension. And of course, unlimited undo and redo, lightning fast 
screen updates, no limits on open files or file size, and full syntax color 
highlighting make CyberEDIT the logical editing choice. 

Outstanding value at just $179. 

Call Now -Triherent Data Systems (800) 700-1237 
International: (415) 428-1237 Fax: (415) 967-3471 

30 Day Money-Back Satisfaction Guarantee. 


Listing 1 continued 


{ 

ClientToScreenthwnd, &pt): 
if (pt.x != ptos->pt.x 11 
pt.y != ptos->pt.y) 

{ /* Drag it some more. */ 
DrawGhost(ptos); 
ptos->pt = pt; 

DrawGhost(ptos); 

I 

I 

else if ((pt.x >= 0 SS pt.x < dyText SS 
pt.y >= 0 SS pt.y < dyText) == 
!(ptos->grftos S ftosHilite)) 
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UM_NCACTIVATE, it sets or clears the ftosActive flag, depend¬ 
ing on whether the owner is being activated or deacti¬ 
vated, and forces the tear-off to repaint itself, i used the 
UM_NCACTIVATE message to trigger the redraw because it 
comes much earlier than UM_ACTIVATE, and so reduces the 
lag between the time when the client window's caption 
changes and the time when its tear-off menu window's 
captions change. 

Now, skipping down to LwTearProcO, you'll find that it 
possesses a case to handle the UM_MOUSEACTIVATE message. 
Windows sends this message whenever the user clicks on 
an inactive window, as part of the process of deciding 
which, if any, window should be activated in response. 
LwTearProcO gives Windows a big hint - it calls SetAc- 
tiveUindowO on its owner and returns the value MA_N0ACTI- 
VATE, which means process the mouse down event, but 
don't activate the tear-off. 

The other message related to activation that gets han¬ 
dled by LwTearProcO is UM_ACTIVATE. This is to deal with a 
peculiar situation that arises with 'always on top" win¬ 
dows. I was running demotear.exe and had created a tear- 
off. I then invoked the clock applet, which I had pre¬ 
viously configured as "Always on top". 1 then minimized 
the clock, and out of nowhere popped the tear-off menu, 
but with no main window in sight! It turns out that Win¬ 
dows in this case literally looks for the previous topmost 
window to activate, regardless of whether it was an inactive 
popup. So, to defend against this occurrence, LwTearProcO uses 
wmPrivate for a second purpose, to inform FilterTearOffO that 


Listing 1 continued 


{ /* Toggle system icon hilite. */ 
ptos->grftos A = ftosHilite; 

PaintSysIcon(ptos, NULL. hdcMem, hbmpSys, 

dyText, bmpSys): 


) 

break; 


case WM_LBUTTONUP: 
case WM_RBUTTONUP: 

if (GetCaptureC) != hwnd) 
break; 

ReleaseCaptureO; 
if (ptos->grftos & ftosDrag) 

{ I* End drag mode. */ 

DrawGhost(ptos); /* Remove ghost. */ 
SetUindowPos(ptos->hwnd, NULL, /* Move */ 
ptos->pt.x - ptos->dpt.x, /* tear-off. */ 
ptos->pt.y - ptos->dpt.y, 0, 0, 
SWPJOACTIVATE I SWPJOSIZE I 
SUPJOZORDER); 
ptos->grftos &= -ftosDrag; 

} 

else if (ptos->grftos J ftosHilite) 

{ /* Click on system icon, so nuke. *1 
DestroyWindow(hwnd); 
return 0; 

) 

break; 

case WMJNTERIDLE; 

if (NULL I s (IwidT = HwndMenuCurC))) 

BeginSnaptptos, hwnd. hwndT, wmPrivate); 
break; 

} 

return DefllindowProcIhwnd, wm, wParam, IParam); 

} 




★ 
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Windows Sockets, 
RPC/XDR, 
Telnet, FTP... 


for Windows 


A 

O 


Windows Sockets, Berkeley Sockets 
Kernel, RPC/XDR, FTP and Telnet 
toolkits ... all in one 
100% DLL (uses only 4K DOS memory) 
Uses less memory than any other DLL or 
TSR implementation even when loaded 
Up to 128 concurrent sockets 
Coexists with Novell, Banyan or LAN 
Manager at no additional cost 
Supports NDIS, ODI and Packet drivers; 
SLIP and PPP with scripting 
TCP Tools: FTP (drag and drop), TFTP, 
Telnet, LPR/LPD, Back-Up with TAR 


fastfacts: 408.867.4742 
fax: 408.741.0795 

email: mktg@distinct.com 


dfstmct 

408.741.0781 



Micro-Software 


RS232-Toolkit, SuperCom 3.0 
for DOS, Windows, I^T, OS/2 


for MS C/C++, Visual C++, Turbo /< 

c Turba/Borland Pascal (hicl, Protedei 

SuperCom is the development tool fb»Ts 

cation software. That means high data 

mission speed. The SuperCom libr< 
tasking operating system like, 

The same programming ii 
languages and operating sys 

• Interrupt driven: transmission, receptio^h^sstatus, • 
modem status. Up to 115,200 bps. 4A?f 

• UARTS: 8250,16450,16550 FIFQpteft&l address. 

• Simultaneous COM_1 ..COM^22lj^unlimited). • 

• Direct register proaram na»aJ!ken BDt-Sharina. 

• Flow control: RTS/CTS, XON/XOFF and 

user defined. ^ 

• Protocols: ASCII, XMODEM, XMODEM/CRC, • 

YMODEM, YMODEM/BATCH, ZMODEM. • 

• Timer, Ctrl-Break and Exception handling. • 

• Multitasking support (Windows, NT, OS/2) • 

• Protected Mode Interface, 386-Technology. • 

• User Event Routines under DOS and Windows. • 

Under Windows user can even post messages to • 
the application using PostMessage. 


'land C/C++, 
~ie). IBM C/C++ 

lbg seriaT commuru- 
'ty and highest trans- 

C riesMare fast even in a multi- 
rs, Windows NT or OS/2, 
s used among different 


Language independent DLL (Windows, NT, OS/2) 
which can be used for simultaneous transfers by 
applications. 

Multiserial board support (AST, ARNET, DigiBoard 
PC/X, STARGATE). Reduces loading of CPU 
through support of intelligent DigiBoard PC/Xe, 
PC/Xi boards. 

Modem support. 

No resident drivers*. Just link the LIB. 

No Royalties. 

FREE technical support. FREE demo 
Full source code (C or Pascal and optimized ASM). 
SuperCom++ (C++ or Pascal OOP) included. 
Protected Mode Interface (Windows) included. 


C/C++ or Pascal package for DOS only $299 
C/C++ or Pascal package for Windows, OS/2 or NT each $399 
C/C++ or Pascal combo pack for DOS+Windows only $528 
C/C++ or Pascal combo pack for Windows+NT only $598 
C/C++ combo pack for DOS+Windows+OS/2 only $799 
C/C++ combo pack for DOS+Windows+NT only $799 
C/C++ combo pack for DOS+Windows+OS/2+NT only $999 



•Under DOS and Windows 3.x 


VISA, MC. COD, Check accepted. 


ADONTEC Computer Systems 

Hoelderlinstr. 32 

D-75433 Maulbronn, Germany 

Phone; 49-7043-40449 
FAX; 49-7043-40440 


Fine Line International 
7000 Malone Rd, Forestville 
CA 95436, USA 

Phone; 1-707-887-3400 
FAX: 1-707-887-1015 
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Listing 1 continued 


7void WINAPI _export UpdateTearOffsCHWND hwnd, HMENU hmnu) 

/*****************************************************/ 

/* -- Update all tear-off menus with for the given */ 

/* popup menu owned by the given window. */ 

/* -- hwnd : Owner window, all if NULL. */ 

/* -- hmnu : Popup menu, all if NULL. */ 

I *****************************************************/ 

{ 

PTOS ptos; 

POINT pt; 

for (ptos = ptosHead; NULL != ptos; 
ptos » ptos->ptosNext) 

{ 

if ((NULL != hwnd 44 hwnd != ptos->hwndOwner) 

II (NULL 1= hmnu 44 hmnu != ptos->hmnu)) 
continue; 
pt.x = 0; 
pt.y = dyText; 

ClientToScreen(ptos->hwnd, 4pt); 
TrackPopupMenu(ptos->hmnu, 

TPM_LEFTALIGN I TPM_LEFTBUTTON, 
pt.x. pt.y, 0, ptos->hwnd, NULL); 

} 

} 

/* End of File */ 


it should activate the main window. I originally tried just 
calling SetActiveUindowO here, as in the UM_MOUSEACTIVATE 
case, but this is a no-no. Windows gets horribly confused 
about who is the active window and things get weird fast. 
Instead, I need to post a message to FilterTearOffO, and 
as before, I need a private message. Instead of allocating 


another registered message, the code just sets IParam to 0 
and posts mPrivate. FilterTearOffO checks IParam when it 
receives mPrivate, and if it is NULL, calls SetActiveUindowO 
on itself. This scheme seems to work, and it avoids the 
reentrant activation problem. 

There are some other janitorial messages in Fil¬ 
terTearOffO and LwTearProcO. When FilterTearOffO re¬ 
ceives UM_DESTROY, it removes and frees any TOS that is at¬ 
tached to the client window, and walks the linked TOS list. 
The code calls DestroyUindowO for each tear-off whose 
owner is the window being destroyed. 

In LwTearProcO, the code for UM_ERASEBKGND just returns 
TRUE and does not bother calling DefUindowProcO. Back¬ 
ground erasing can be ignored for tear-off menu windows, 
since the client area is completely filled with the small sys¬ 
tem icon, caption, and menu image. LwTearProcO's UM_DE¬ 
STROY case is a little more interesting. It first sends a 
wmTearOffDestroy to the owner window, to inform it of the 
death of one its tear-off menu windows. It then removes 
its TOS from the linked list, by enumerating the list with a 
pointer to a TOS pointer. This eliminates having to deal 
with a special case when the TOS is at the head of the list. 
Finally, it frees the TOS. 

The code for the next five cases in LwTearProcO, from 
UM_LBUTT0ND0UN to UM_RBUTTONUP, implements the mouse in¬ 
terface to tear-offs. The common block of code for 
UM_LBUTT0ND0UN and UM_RBUTT0ND0UN messages first calls Set- 
UindowPosO to bring the window to the top of the z order 
without activating it. BringUindowToTopO is not useful here. 
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since it also activates the window. The code then deter¬ 
mines which part of the tear-off menu window was hit (for 
a left mouse down). If the mouse down occurred in the 
caption, or if a right mouse down occurred anywhere in 
the tear-off, then LuTearProcO will enter its own drag 
mode. The first test checks if the click occurred above the 
menu image. If so (or if the message is UM_RBUTTONDOUNj, the 
next test sees if the mouse down happened outside of the 
system icon, that is, if it occurred in the caption. If so, the 
code prepares to enter drag mode, first ensuring that all 
sibling tear-offs are validated by calling UpdatehlindouO for 
each. The initial mouse-down location in screen coordi¬ 
nates and relative to the tear-off is stored in the TOSs pt 
and dpt members, respectively. The ftosDrag flag is set to 
indicate the tear-off is in drag mode, 
and the ftosOn flag is cleared here at 
the beginning of the drag, since the 
ghost frame has not yet been shown. 

DrauGhostO (described last month) is 
then called to display the ghost 
frame, and the mouse is captured. 

If the first test in the UM_LBUTTON- 
DOUN and UM_RBUTTONDOUN case succeeds 
but the second fails, it means the 
user moused down in the system 
icon. In this case the ftosHilite flag is 
set, PaintSysIconO is called to high¬ 
light the icon, and the mouse is cap¬ 
tured. The system icon behaves like 
a button in that it tracks the mouse 
and does not dismiss the tear-off un¬ 
less the user mouses up in the sys¬ 
tem icon as well. 

If the first test fails, then the 
mouse down occurred in the menu 
image. In this case, the mouse coor¬ 
dinate supplied in IParam is converted 
to a screen coordinate, and the fto- 
sTearMenu flag is set in the TOSs 
grftos. Setting the ftosTearMenu flag 
prevents the UMJNITMENUPOPUP code in 
FilterTearOffO from reacting to the 
menu that is about to be popped up 
by the ensuing call to TrackPopup- 
Menu(). Even though TrackPopupMenuO 
will display the menu on top of the 
tear-offs menu image, it passes the 
owner window as the hwnd parame¬ 
ter, so that the owner window will re¬ 
ceive all the menu-related messages. 

This enables tear-off submenus to be 
treated exactly the same as if they 
had originated from the menu bar. 

The next case handles 
HM_M0USEM0VE messages. If the mouse 
has not been captured, they are ig¬ 
nored. Otherwise, the first test checks 
to see if the tear-off is in drag mode. 

If it is, the ghost frame is moved, un¬ 


less the next test determines that the mouse location 
hasn't moved since the last message. Moving the ghost 
frame is a matter of calling DrauGhostO once to XOR the 
frame away, updating the current mouse location, and 
calling DrauGhostO again to XOR the frame in its new loca¬ 
tion. 

If the tear-off is not in drag mode, then the system icon 
is tracking the mouse, else the mouse would not be cap¬ 
tured. In this case, the next test determines if the location 
of the mouse has changed in terms of being inside or 
outside the system icon since the last message. If it has 
changed, the ftosHilite flag is toggled, and PaintSysIconO 
is called to repaint the icon. 


A Total Forms Processing Tool Kit 
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The last two mouse cases are UM_LBUTTONDP and UM_RBUT- 
TONUP. As with the UM_M0USEM0VE case, if the mouse has not 
been captured, there is nothing to do, and the code re¬ 
turns. Otherwise, the mouse is released. If the ftosDrag flag 
is set, then the tear-off was in drag mode, so the code 
calls DrawGhostO to XOR the ghost frame away, then calls 
SetUindowPosO to relocate the tear-off window to the final 
location, and then clears the ftosDrag flag. If the tear-off 
was not in drag mode, in which case the system icon was 
tracking the mouse, and the mouse up occurred with the 
system icon highlighted, then the user has dismissed the 
tear-off, so the code calls DestroyklindouO to nuke the tear- 
offs window. 

There is only one message left to cover in LwTearProcO, 
UM_ENTERIDLE, but before I do, I need to explain Up- 
dateTearOffsO. This routine walks the list of tear-off menu 
windows, looking for each tear-off menu window that 
matches the criteria for being updated. First, if non -NULL is 
passed for the hwnd parameter, then only those tear-off 
menu windows owned by the given window are eligible; 
else, all are. Second, if non -HULL is passed for the hmnu pa¬ 
rameter, then only those tear-off menu windows contain¬ 
ing the given menu are eligible; else, all are. Eligible tear- 
offs satisfy both tests. So, inside the loop, for each eligible 
tear-off, TrackPopupMenuO is called to display its popup 
menu. But in this call to TrackPopupMenuO, the tear-off 
menu window's handle is passed, so that LwTearProcO 
will receive the menu-related messages, especially 
UM_ENTERIDLE. 


One Party! 

Why get bogged down with third party DOS extenders and C compilers, 
when all you want Is to write 32-blt Windows programs? With LPA 
386-PROLOG 2.0, you get everything you need to write really stunning 
applications: 


O True 32-blt stacks, heaps, programs Se data 
O Fully programmable dialogs, menus Se windows 
O High level access to the GUI and operating system 
O Two-way data exchange through DLLs 


Not to mention the Integrated source level debugger, multl-flle program 
editor, Incremental and optimising compilers, and full Prolog predicate 
library. 


All this, and much more, without the 
need to buy any third party DOS 
extenders or C compilers. 

386-PROLOG Is your one party, 32-blt 
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for Windows 3.1! 
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Unlike FilterTearOffO's handling of UM_ENTERIDLE, which 
will create a new tear-off, LwTearProcO only needs to the 
reinitialize an existing tear-off from the current state of the 
menu. It gets the topmost menu window and calls Begin- 
SnapO to initiate the snapshot process, but passes the tear- 
offs window handle as the recipient of the wmPrivate mes¬ 
sage. BeginSnapO does its stuff by removing the menu se¬ 
lection and posting the wmPrivate message back to LwTear¬ 
ProcO. As is true of FilterTearOffO, by the time LwTear¬ 
ProcO receives wmPrivate, the selection has been removed 
and the menu is ready for picture taking. To handle the 
wmPrivate message, FilterTearOffO calls EndSnapO, this time 
passing FALSE for the value of fNew. As a result, EndSnapO 
does not bring the window to the top of the z order and 
does not go into drag mode if the right mouse button is down. 

Enhancements 

I had to cut a number of features in order to imple¬ 
ment and describe tearoff.dll within the confines of a 
magazine article. Depending on your needs, you may 
want to implement some (or all) of them to have a really 
slick and professional-looking user interface. 

A major target for improvement is the requirement that 
the user depress two mouse buttons to tear a menu off. 
This would be a much smoother interface if the right 
mouse button behaved the same as the left while in the 
menu bar, then, as soon is it was dragged into a popup 
menu, the menu was converted to a tear-off in drag 
mode. This would preclude being able to drag an existing 
tear-off by clicking anywhere with the right mouse button, 
but I don't see that as a big loss. (See the September '92 
Q&A for more on using the right mouse with menus.) 

Currently, there is no code to handle the case when the 
title of a tear-off is too wide to fit in the caption. It should 
be a straightforward matter to modify the call to 
CreateUindowO in the wmPrivate case of FilterTearOffO to 
handle this detail. 

Instead of dragging just the outline of a tear-off, I think 
it would be more appealing to drag the actual image. I 
tried to do this the easy way by calling SetUindowPosO 
each time the mouse was moved instead of making the 
two calls to DrawGhostO, but this proved to be very flaky. If 
you happen to have an "always on top' window and drag 
a tear-off underneath it using SetUindowPosO, after a while 
Windows blows up spectacularly inside some unknown 
code segment with a trashed stack. This is a bug in Win¬ 
dows 3.1, but I'm not sure where. The thing to do would 
be to capture a bitmap of the entire tear-off, including the 
caption, and use sprite animation to drag the image 
around on the screen. The MSDN CD contains an excel¬ 
lent article on sprite animation by "Herman Rodent," enti¬ 
tled "Animation in Windows', dated April 28, 1993. 

Currently, all errors are handled silently, without client 
notification. To really make this into commercial quality 
code, it would be nice to have an error notification 
mechanism, maybe something similar to an edit control's 
EN_ERRSPACE, to inform the client when a tear-off operation 
cannot be performed due to an out-of-memory condition 
or whatever. □ 
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WUIMAN’s User Interface 


Ron Burk 


Borland C++ v4.0 
i 1 !' 1 — 1 Symantec C++ v6.2 

Visual C++ vl .5 


This is the seventh in a series of columns about the design and implementa¬ 
tion of WUIMAN (a Windows User Interface MANager). This installment de¬ 
scribes the first version of a user interface for manipulating WUIMAN objects, 
and hence the complete user interface for a Windows program. 

Building a User Interface 

WUIMAN is basically a dynamically modifiable text database that describes 
a Windows program's user interface. In past columns, I have been implement¬ 
ing various aspects of that database. This month, I started creating a user inter¬ 
face for interactively manipulating the WUIMAN database. 

At one extreme, I would like the interface to the WUIMAN database to in¬ 
volve direct manipulation. For example, if you wanted to alter a menu item 
that currently appears on the screen, you would enter some kind of edit mode, 
directly select the item you want to change, change it, and see the result in¬ 
stantaneously. Unfortunately, that kind of interface is a lot more work than I 
want to invest right now. At another extreme, WUIMAN stores its database in a 
.ini file, which you could edit with any text editor. However, the data in the 
. ini file is not terribly convenient to read and manipulate. As a compromise, I 
am building a dialog box that makes it easy to view and edit the WUIMAN 
database. Even if I build an interface involving direct manipulation later, this 
code should still be useful, since there will always be times when you want to 
change some aspect of the user interface without having to invoke the pro¬ 
gram to display the window or menu you want to modify. 


Ron Burk 


Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 
mer for 72 years. He is working on a book tentatively titled WinHelp for Programmers 
and Technical Writers. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ronb@rdpub.com (“ . . . iuunetirdpubironb"). 

















Figure 1 WUIMAN’s user interface 


Traversing the Tree 

Figure 1 shows the dialog box 1 created for the WUI- 
MAN user interface. The code is still a work in progress, 
but much of the functionality is in place. As Figure 1 
shows, I use an owner-draw listbox to draw the WU1MAN 
hierarchical database as a tree, similar to the way that File 
Manager displays directory structures. Double-clicking on 


any node of the tree expands the 
node to show its children or (if it was 
already expanded) collapses it. 

WUIMAN objects can have child 
objects and they can have attributes. 
WUIMAN object attributes are treated 
uniformly at the lowest level; how¬ 
ever, it is convenient to divide them 
(as Visual Basic does) into properties, 
methods, and events. As described in 
earlier columns, I use a simple prefix 
naming convention to distinguish the 
categories of attributes: 'p_' for prop¬ 
erties, 'm_' for methods, and *e_' for 
events. The user interface in Figure 1 
hides this detail from the user and 
gives the illusion that WUIMAN ob¬ 
jects are more similar to Visual Basic 
custom controls than they really are. 

The key to interfacing with the 
WUIMAN database is the fact that all 
objects in the database support two methods: m_Child() 
and m_Attributed. Note that these are WUIMAN object 
methods, not C++ object member functions. If you pass 
m__Child() no arguments, it returns the number of child 
nodes that the object contains. If you pass it a zero, it 
returns the first child node's name, passing a 1 returns the 
second child node's name, and so on. m_Attribute() pro¬ 
vides analogous operations for the attributes of a node. 


Cand C++ DOCUMENTATION 


C-METRir ($59) COMPLEXITY / QUALITY 

• Calculates cyclomatic path complexity for functions and 

• Counts lines with comments, code, and ’C statements 


system 


filel 

main 

file2 

—sub2 

file2 

1—sub3 

file2 

1—sub4 

filel 

— main (recursv) 


— Ibryl, Ibry2 


C-CALL m ($69) FUNCTION HIERARCHY 


Tree-Diagram showing function hierarchy 

• Table-Of-Contents of functions versus files 

• Summary and detailed cross-reference of functions 


C-CMT ($69) FUNCTION COMMENT 

• Generates and inserts function comment blocks 

• Can be re-run to update the comment blocks 

• Retains any user-generated comments 


while (icj) 

if(i<k) { 

! 


break; 

} 


MQ); 


r ff. 

sub2 USERS: main 

CALLS: sub3 sub4 
PAR AM: argl arg2 
LOCAL: varl 
GLOBL: var2 var3 

;Urn 


C;USl1$ft>) LISTS QR REFORMATS 

■ Action-Diagrams show logic/control flow 

• Optional line numbers, page numbers, and titles 

• Reformats source to various standardized formats 


C-REF ,m ($59) CROSS-REFERENCES IDENTIFIERS 


Local/parameter/global/define summary or cross-reference 

• Produces class-hierarchy tree-diagram for C++ classes 

SPECIAL: ($199) C-POtT DOS 


1 Packae 

rail C DO( 


e ($325 Valuef 


All 5 programs fully integrated as 1 overall C-DOC program 

• Processes multiple directories/files up to 15,000 total lines 

• Unconditional 30-day money-back guarantee of satisfaction 

NEW: C-DOC M Professional ($299): DOS. OS/2, Windows 

• Processes 150,000 lines, 3-ring binder/case, 2-pass deferred reports 


!! NEW 5.0 !! Point-and-click G.U.I. operation !! 


SOFTWARE BLACKSMITHS INC 

6064 St Ives Way, Mississauga 
ONT Canada L5N-4M1 


Voice/Fax: (416 )-X5X-44f>6 

Demo/BBS: (416)-858-1916 


□ Request 108 on Reader Service Card D 
Page 56 — Windows/DOS Developer's Journal 



With color reduction 
for fast, accurate 
24-bit image display 


Image Processing Library 

Create Powerful Image Applications 

for FMF, TIFF, FCX, GIF, TGA, and JFEG Images 


► Load and save 
BMP/TIFF/PCX/GIF/TGA/JPEG 

Ipt Powerful grayscale and color 
image processing: brightness, 
contrast, sharpen, outline, 
equalize, matrix convolution, 
rotate, resize, and more 

(► Color reduction for fast and 
accurate display of 24-bit images 

§► Support for EGA/VGA/SVGA, 32K- 
and 16 million-color displays 

!► Scan b/w, 

’ images with 

► Print halftones, diffusion scatters, 
and color pictures 



, and color 
i ScanJet scanners 


■ Convert images between 1-, 8-, 
and 24-bit formats 

' Convert color to grayscale 

• Includes a complete image 
processing application with C 
source 


files, control scanner and printer, and have 
powerful Image processing and color 
reduction for the very best Image display. 

Victor Image Processing Library 
for Windows (DLL), $295 

Victor Image Processing Library 
for DOS, supports Microsoft 
and Borland C/C++ compilers, $195 

Call or fax to order 
314-962-7833 


f'Catenary Systems 

470 Belleview St Louis MO 63119 

voice/fax 314-962-7833 

Victor Image Processing Library for Windows or for DOS, No royalties Source code available, visa/mc/cod. 


□ Request 179 on Reader Service Card □ 


April 1994 























































































These two methods are all that are needed to obtain the 
data drawn in the listbox. 

Figure 2 shows an example of using m_Child(). 
LoadLevelO is an internal function that the WUIMAN user 
interface calls when it needs to locate and display the chil¬ 
dren of a particular node in the WUIMAN database. Figure 
3 shows an example of using ia_Attribute(). DisplayAttrib- 
utesO gets called whenever the user selects a different 
WUIMAN object in the owner-draw listbox. It uses m_At- 
tributeO to fetch the attributes of the selected object and 
display them in comboboxes in the dialog. DisplayAttrib- 
uteValueO, also in Figure 3, uses UUIMAN_Get() to display 
the values of the currently selected attributes. Unlike event 
attributes and property attributes, method attributes do 
not, strictly speaking, have dispiayable values: calling UUI- 
MAN_Get() executes the specified method and fetches any 
return value. That's why the dialog box has no place to 
display the values associated with methods. 

Bells and Whistles 

WUIMAN is designed to be independent of its user in¬ 
terface - I used only the two standard functions UUI- 
MAN_Get() and UUIMAN_Set() to implement the interface 
shown in Figure 1. This is turning out to be a good test of 
whether I have actually exported the right kinds of func¬ 
tionality. One problem that arose immediately was that I 
had not defined any way for external software to know 
the maximum size of WUIMAN node names (a useful con¬ 
stant to know when traversing the database). Therefore, I 
added the constant UUIMAN_MAXNAME to wuiman.h. 

It also quickly became apparent that I needed an easier 
way for the calling code to report WUIMAN errors to the 
user. WUIMAN itself does not pop up error messages, it 
merely returns error codes. In the user interface, though, I 
wanted to know immediately about any error returns so I 
could see if some object was not behaving as expected. 
To deal with this, I added a new global character array, 
UUIMAN_LastError, that contains a text description of the 
most recent error reported by UUIMAN_Get() or UUIMAN_Set(). 
Using a global variable for something like this is not the 
most elegant approach, but it has the redeeming quality 
of being easy to use. 

I used a Windows metafile to draw the open and 
closed boxes in the owner-draw listbox; Figure 4 shows 
the function that does the trick. Using a metafile is pretty 
slow, but it makes it possible to draw the box in a device¬ 
independent way. I could make things faster by playing 
the metafile once into a memory display context at 
startup, and then using BitBltO to display the resulting 
bitmap thereafter. 

Bug+4- of the Month 

I'm happy to report that the compiler bug of the month 
I've selected has already been fixed, but it still makes an 
interesting case study in dealing with bugs in C++ in gen¬ 
eral. 

I use three C++ compilers (Borland, Symantec, and Mi¬ 
crosoft) during development and I periodically switch 
among compilers to help detect bugs and to verify that I 


am using a subset of the language that all three vendors 
can agree upon (especially Visual C++, since it trails far 
behind the other two compilers in tracking the evolving 
C++ language standard). During one recent session, I 
switched to Symantec C++ v6.0, rebuilt the WUIMAN pro¬ 
ject, and immediately got an assertion error when I ran 
the executable. 


Figure 2 Traversing WUIMAN child nodes 


struct CustomList 
{ 

CustomList ‘Parent; 

char Text[WUIMAN_MAXNAME]; 

int Level; 

int LastSibling; 

char Path[256]; 

int Opened; 

}; 


static 

CustomList *NewEntry(HWND Window, char ‘Path, char ‘Node, 
CustomList ‘Parent, int Level) 

{ 

CustomList ‘Entry = new CustomList; 
if(iNode II !Node[0]) 
strcpy(Entry->Text. 

else 


strcpy(Entry->Text, Node); 
Entry->Parent = Parent; 

Entry->Level = Level; 

strcpy(Entry->Path, Path); 
Entry->LastSibling = FALSE; 

Entry->Opened = FALSE; 

SendMessageCWindow, LB_ADDSTRING, 
return Entry; 

} 


9, (LPARAM)Entry); 


static 

int LoadLeveKHWND Listbox, CustomList ‘Parent, 

char ‘Path, int Level) 

{ 

long NChildren = WUIMAN_Get(Path, ”m_Child", NULL, 0); 
if(NChildren < WUIMAN.ERRORS) 

MessageBoxCNULL, WUIMAN JastError, 

"WUIMAN:LoadLevelO", MBJK); 

CustomList ‘Entry = 0; 
for(int i = 0; i < NChildren; ++1) 

{ 

char ChildName[WUIMAN_MAXNAME]; 
char Chi 1dNumber[WUIMAN_MAXNAME]; 
sprintfCChildNumber, "m_Chi1d(%d)”, i); 
long Status = WUIMAN_Get(Path. Chi 1dNumber, 

ChildName, WUIMAN_MAXNAME); 
if(Status < WUIHAN.ERRORS) 

MessageBox(NULL, WUIMAN_LastError, 

"WUIMAN;LoadLevel(child)”, MBJK); 
char ‘End = Path + strlen(Path); 
if(End[-1] != 7’) 
strcat(Path, "/"); 
strcattPath, ChildName); 

Entry = NewEntry(Listbox, Path, ChildName, Parent, 

Level); 

‘End = ’\0'; 

} 

if(Entry) 

Entry->LastSibling = TRUE; 
return (int)NChildren; 

} 
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An assertion error in WUIMAN is both good news and 
bad news. I've tried to aggressively use assertions in the 
code so that errors are quickly caught before things go 
too far wrong. Also, when I discover a bug that did not 
cause an assertion error, I try to go back and add the 
smallest number of assertions that would detect the same 
error in the future. As a final defense against total disaster, 
I put an assertion in each member function that asserts: 

ASSERT(this != NULL); 

Unfortunately, it was just such a low-level assertion that 
failed, and I could not see any obvious reason why. 
Worse, the assertion only failed with Symantec, not with 
Borland or Microsoft. That fact led me to believe that 
either Symantec C++ had a bug or, much more likely, I 
had a wild pointer that only happened to clobber some¬ 
thing important in the Symantec version of the .exe. 

After some tedious paring down of the code, to my 
surprise the assertion seemed to be a compiler error, hav¬ 
ing to do with generating the this pointer correctly for 
temporary objects. The good news was that Symantec had 
already fixed the problem and was shipping an upgrade 
(Symantec C++ v6.1) that got me going again. 


Later during that same week, WUIMAN started produc¬ 
ing some garbage in a listbox, but only when compiled 
with Symantec C++ v6.1. Even though the odds were logi¬ 
cally against it, it was only human nature for me to sus¬ 
pect a compiler bug this time, instead of my own code. 
However, this time the error was caused by a situation 
like this: 

int foo(char *Path) 

{ 

strcat(Path, ".Data"); 

II... 

} 

foot”/"); 

i was passing a string constant to a function that ex¬ 
pected a character array that it could scribble on. As a 
result, I was clobbering constant data and, as luck would 
have it, Symantec C++ was the only compiler that hap¬ 
pened to arrange the static data in such a way that my 
bug clobbered something that produced visible garbage. 
At first, I did a double take - why didn't C++ warn me that 
I was passing a string constant to a function expecting a 


Figure 3 Traversing WUIMAN object attributes 


static 

void Di splayAttributes(HWND Dialog, char *Path) 

{ 

int Boxes[3] = 

{ID_PR0PERTY_C0MB0,ID_METH0D_C0MB0,ID_EVENT_C0MB0}; 
int i; 

for(i = 0; i < 3; ++i) 

SendDlgltemMessagetDialog, Boxesfi], 

CB_RESETCONTENT, 0, 0); 

long NChildren = WUIMAN_Get(Path, ”rn_Attribute", 

NULL, 0); 

if(NChi ldren < WJIMANJRRORS) 

MessageBoxtNULL, WUIMAN_LastError, 

"WUIMAN:DisplayAttributes", MB_0K): 
ford = 0; i < NChildren; ++i) 

{ 

char ChildName[WUIMAN_MAXNAME]; 

char ChildNumber[WUIMAN_MAXNAME]; 

sprintf(ChildNumber, "m_Attribute(*d)", i); 
long Status = WUIMAN_Get(Path. ChildNumber, 

ChildName, WUIMAN_MAXNAME); 
if(Status < WUIMAN_ERRORS) 

{ 

MessageBoxtNULL, WUIMAN_LastError, 

"WUIMAN:DisplayAttributes", MB_0K); 

continue; 

} 

int j; 

switch(ChildName[0]) 

{ 


case 

V 

j = 0; break; 

case 

'm' 

j = 1; break; 

case 

'e' 

j = 2; break; 

default 


j - 0; 


} 

long Err = SendDlgltemMessagetDialog, Boxes[j], 
CB_ADDSTRING, 0. (LPARAM)(LPCSTR)(Chi 1dName+2)); 
if(Err < 0) 

DEBUG_ERROR("ERROR RETURN FROM CB_ADDSTRING"); 

} 


char ClassName[WUIMAN_MAXNAME]; 

long Status = WUIMAN_Get(Path, "m_ClassO", ClassName, 

WUIMAN_MAXNAME); 

if(Status < WUIMAN_ERRORS) 

MessageBoxtNULL, WUIMAN_LastError, 

"WUIMAN:DisplayAttributes", MB_0K); 
else 

SetDlgltemTexttDialog, ID_CLAS$_NAME, ClassName); 
ford = 0; i < 3; ++i) 

SendDlgltemMessagetDialog, Boxesti], CB_SETCURSEL, 


static 

void DisplayAttributeValue(HWND Dialog, char *Path, 

int Combo, int Text) 

{ 

char AttributeName[WUIMAN_MAXNAME+3]; 

char Prefix; 

switch(Combo) 

{ 

case ID_PR0PERTY_C0MB0 : Prefix = ’p’; break; 

case ID_METH0D_C0MB0 : Prefix = 'm'; break; 

case ID_EVENT_C0MB0 : Prefix = ’e'; break; 

) 

if(Text) 

{ 

AttributeName[0] = Prefix; 

AttributeName[l] = 

GetDlgltemTexttDialog, Combo, AttributeName+2, 

WUIMAN_MAXNAME); 

TCharBuffer Value(1024*4); 

long Status = WUIMAN_Get(Path, AttributeName, 

Value, 1024*4); 

if(Status < WUIMANJRRORS) 

MessageBoxtNULL. WUIMAN_LastError, 

"WUIMAN (DisplayAttributeValue)", MB_0K); 
SetDlgltemTexttDialog, Text, Value); 

} 
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C CODE FOR THE PC 

source code, of course 

Graphic 7.0 (high-resolution, scientific plots in color & hardcopy, contour plots, device independence).$370 

X/DOS and Xt/DOS (Xlib with X client and Xt toolkit for DOS; port X code to DOS; Xt/DOS requires X/DOS and 32-bit compiler) . . each $300 
ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, merge images, TlFr/GIF/PCX/bin, HP ScanJet support) . . $290 
TE Editor Developer’s Kit for Windows V3.5 (full screen editor, undo command, word processing; TER for application build-in; no royalties) $280 
C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions, Jolt Award winner, specify C or C++)$250 

TUrbolhX (Release 3.0; HP, PS, dot drivers; CM fonts; LaTgX; MetaFont).$250 

Rogue Wave tools.h++ or math.h+-(- Class Library (extensive docs).each $240 

NEW! Crusher! VZOO (platform-independent data compression for network transfer, beats PK & LH on binary; directory trees; portable C) .... $215 

COMM-DRV (complete interrupt-driven serial communication libraries & device drivers; full source).$155 

TE Editor Developer’s Kit Ver. 3.0 (full screen editor, undo command, multiple windows; with Word Processing $230).$155 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25” or 3.5” diskettes).$150 

XASM (cross assemblers & utility programs; 65xx, 68xx, 80xx; Intel or Motorola hex format; macro preprocessor).$150 

Delorie GCC for MS-DOS (Version ZZ2; includes C+ +, assembler, DOS extender, 387 emulation; complete source oode and makefiles) . . $150 
Updated! Moby Crypto (PGP, DES, Secure Hash, UFC, MDs, Crack 4.1, Lucifer, IDEA, VCR+, large integer packs, tutorials, more; not for export) . . $150 

Lisp for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building muted Lisp/C programs) .$140 

Ibrow (Version 4.1; programmer’s Windows-based editor; large files, help, undo/redo, drag-n-drop, function & type tags).$135 

Updated! SCM (portable Scheme in C, IEEE standard, includes JACAL symbolic math package; SCM-4D0/SLIB-1D5/JACAL-1A3) .$100 

PC/IP (CMU/MIT TCP/IP for PCs; Crynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

DA (disassembler for Microsoft’s New Executable (NE) binary files including Windows .exe, .drv, .dll, and .fit).$95 

Script Interpreter (a command script interpreter for DOS-based systems; C-fike script language; lots of features).$90 

CEL? 3.2c (Federal Standard 1016 Code Excited Linear Predictive voice sampling and encoding; voice over 4.8kbps; Unix code).$80 

CPPCOMM (C+ + serial communications class library for DOS, Windows, OS/Z and NT; includes X/Y/Zmodem).$75 

ET Neural Net (back error propagation and Kohonen).$75 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C+H(-).$65 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

Updated! PCCTS Version 1.10 (Purdue Compiler Construction Tbol Set; like YACC and LEX together with lots of additional features).$60 

Container Lite V 1.82 (C+ + & FLC wrapper emulators; portable, persistent containers of arbitrary data including pointers).$50 

BigFloat (arbitraiy precision floating point arithmetic and functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

CLIPS Version 6.0 (rule-based expert system generator, Windows compatible; manuals on disk).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

OBJASM (convert .obj files to .asm files; output is MASM compatible) .$50 

Editor Pack (20 public domain editors; micromacs 3.12, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF).$50 

Exceptions for C (Ada-like exception handling for C programs; exceptions for any block; exceptions can be reraised).$45 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; not for export).$40 

Database Pack (9 databases - simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C+ + in C) .$35 

NE W! OCT (Object C Translator; essentially Brad Cox’s Objective-C Version 4) .$35 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes Cand C++ grammars) .$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

REGX Plus (Version 3.0, search and replace string manipulation routines based on compiled regular expressions).$30 

GNU Awk & Did for PC (both programs in one package)..$30 

Big Number Pack (7 arbitraiy precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

NE W! OORT (C+ + ray tracing code from the book by Nicholas Wilt) .$30 

OEmacs (full GNU Emacs for DOS and Windows DOS box; C+ + support, etags++, lots of .el files) .$25 

NEW! CTask Version 2.22d (robust MS-DOS multitasking kernel; C functions run as light-weight processes; mailboxes, interrupts, pipes, etc.) . . . $25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

Updated! FLEX Version 2.4.3 (fast lexical analyzer generator, new, improved LEX).$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development).$20 

Data 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, ’’common sense”, concept related searches) .$500 

Moby Pronunciator II (175,000 words & phrases encoded with full IPA pronunciation & emphasis points).$265 

Moby Part-of-Speech II (230,000 words and phrases described by prioritized part(s)-of-speech).$170 

Moby Hyphenator II (185,000 words fully hyphenated/syllabified).$105 

Moby Words II (610,(XX) words & phrases with Scrabble(tm) word list, place names, baby names, acronyms, core list for spell checkers) . . . $100 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; 5.25” HD only).$35 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

The World Digitized (100,000 longitude/latitude of world country boundaries).$30 

CD-ROMs 

BSD/386 (POSIX-compatible O/S; complete development package, full networking, kernel debugger, X11R5, DOS box; complete source code) $900 

NEW! AI CD-ROM (expert systems, neural networks, genetic algorithms, fuzzy logic, linguistics/naturattanguage).$105 

FontMaster II CD Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB) . . . $70 

Updated! Prime Time for Unix (Volume 3, No. 1, January, 1994; over 6GB of Unix C code).$60 

Whlnut Creek Libris Britannia (over 600MB of the best of British boards; not all source included).$55 

NE W! Mailer’s Lookup (9-digit ZIP codes by street address or company name, distances between ZIP codes, phone locations; on-line tool) .... $50 

Linux/GNU/X by Yggdrasil Computing (1st production release; run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more) . $45 

Wfalnut Creek C Useris Group (Volumes 100 to 364).$40 

InfoMagic Unix (three public domain Unix systems: 386BSD (version 0.1), Linux (version 0.99.10), and NetBSD).$40 

InfoMagic Source Code (Berkeley Net/Z MACH, GNU, Interviews, X, Andrew, XFree, Demacs & Winemacs, djgpp, Modula-3, etc.) . . . $40 

Knowledge Media Multimedia (625MB & 13,000 files; 1,232 sounds, 179 books, 100 movies, 114 stacks, 606 programs, 214 mods) .$35 

Project Gutenberg (literature, historical documents, reference books, census data, religious documents, math constants, etc.) .$35 

Knowledge Media Languages & Operating Systems (640MB of compilers, libraries, and operating systems; source code & executables) . . . $35 

Walnut Creek X11R5 and GNU (X11R5 with contributed and comp.sourcesx, over 120 GNU programs, complete C source).$35 

Vfalnut Creek Usenet and Simtel Unix-C (600MB).$35 

Walnut Creek Giga Games (arcade, simulations, card games, education, trivai, cheat sheets; some source).$35 

Austin Code Works Internet Warrior #1 (PC Internet tools: Gopher, Wais, Eudora, ph, Nupop, Uumpet, TCP/IP, FAQs, drivers, docs) . . . $35 

NEW! Walnut Creek FreeBSD (Berkeley 32-bit operating system for PCs; bootable).$35 

NEW! Walnut Creek Tbolkit for Linux (Slackware distrubtion and complete Linux archive).$35 

NEW! Knowledge Media MegaMedia I and II (images, sounds, movies).each $30 

Walnut (Seek CICA Windows Archive (August 1993) .$25 

Whlnut Creek Simtel 20 MSDOS Archive (C source code but lots of other stuff too).$25 

The Austin Code Works Voice: ( 512 ) 258-0785 

11100 Leafwood Lane much more ... ask for catalog FAX: ( 512 ) 258-1342 

Austin, Texas 78750-3587 USA E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 
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Figure 4 Drawing boxes with a metafile 


HMETAFILE CreateObjectBox(int Width, int Height, 

int OpenedBox) 

{ 

HBRUSH GrayBrush = (HBRUSH)GetStockObject(LTGRAY_BRUSH); 
HBRUSH WhiteBrush = (HBRUSH)GetStockObject(WHITE_BRUSH); 
HPEN BlackPen = (HPEN)GetStockObject(BLACK_PEN); 
static POINT BoxLeft [] = 

{ {1,4}, {1,10}, {4,13}, {4, 7} }; 
static POINT BoxFront [] = 

{ {4,7}, {4,13}, {18,13}, {18,7} }; 
static POINT Boxlnside [] = 

{ {4,7}. {18,7}, {15,4}, {1,4} }; 
static POINT BoxLid [] = 

{ {1,4}, {15,4}, {18,1}, {4.1} }; 

{{define NCLOSEDPOINTS \ 

(sizeof(ClosedBoxOutline)/sizeof(POINT)) 
HOC MetaFile = CreateMetaFi1e(NULL); 
SelectObjecttMetaFile, GrayBrush); 

SelectObject(MetaFi1e, B1ackPen); 

PolygontMetaFile, BoxLeft, 4); 

PolygontMetaFile, BoxFront, 4); 
if(OpenedBox) 

SelectObjecttMetaFile, WhiteBrush); 

PolygontMetaFile, Boxlnside, 4); 
if(OpenedBox) 

{ 

SelectObjecttMetaFile, GrayBrush); 

PolygontMetaFile, BoxLid, 4); 

} 

return CloseMetaFi1etMetaFi1e); 

} 


non -const character pointer? Sadly, the answer is that the 
language specifically allows this laxness for compatibility 
with C: string constants are not treated as const in C++. 

I drew two conclusions from my two bugs. First, careful 
use of assertions has more than paid for itself in this pro¬ 
ject. I rarely use a debugger with WUIMAN; at most, I typi¬ 
cally just run Bounds-Checker for Windows to get a sym¬ 
bolic stack traceback when an assertion fails, and that 
quickly points me to the precise problem. Second, the 
type-safe features of C++ pay for themselves. When I dis¬ 
covered the const versus non-const string bug, I suddenly 
realized that I simply don't expect to run into data type 
mismatch bugs any more. Back in the days of K&R C, this 
sort of thing was a popular way for me to waste debug¬ 
ging time. 

Summary 

This month's code disk has the complete WUIMAN 
source, including code from past issues. The code disk is 
widely available via sources listed in the table of contents. 
Next month, I plan to finish up the WUIMAN user inter¬ 
face, building in the ability to interactively inspect and 
change WUIMAN objects, their attributes, and attribute 
characteristics such as inheritabiiity. □ 


Windows/DOS Developer’s Journal 

is seeking articles on the topics listed 
below. In addition, we are interested in 
articles related to Windows NT, 
Win32s, and the Win32 API. If you 
have an idea for a related story and 
experience that would especially qualify 


Windows™/DOS Developer’s Journal 

Call For Papers 

you to write on one of these topics, 
contact our editorial staff for Author 
Guidelines at: 

Windows/DOS Developer’s Journal 

1601 West 23rd St., Suite 200 
Lawrence, KS 66046-2743 
(913) 841-1631; FAX (913) 841-2624 


Proposals should include a short ab¬ 
stract, preferably followed by a one- 
page outline of the article. A brief re¬ 
sume of the author’s qualifications 
should accompany the proposal. 


Object-Oriented 

Programming 

■ Proposals due 4/4/94 
manuscripts due 5/16/94 

Suggested topics: A C++ class for 
loading, saving, and displaying bit¬ 
maps. A C++ wrapper for Chicago’s 
new listbox control. A survey of tech¬ 
niques for connecting windows to 
C++ objects 


Memory Management 

■ Proposals due 5/5/94 
manuscripts due 6/15/94 
Suggested topics: A benchmark 
program for C and C++ memory 
managers. A User Report on third- 
party memory management software. 
Tips for using system and user mem¬ 
ory efficiently under Windows. Soft¬ 
ware that measures C/C++ heap 
fragmentation. 


Graphics 

■ Proposals due 6/6/94 
manuscripts due 7/15/94 

Suggested topics: Performing ani¬ 
mation under Chicago. Tips on port¬ 
ing graphics to NT. Code to play 
back .fli files under Windows. 
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Paul Bonneau 


Send questions to Paul via Internet as 

paulPrdpub.com 

from CompuServe: 

>INTERNET:paulPrdpub.com 
or in care of this magazine at: 

1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2700. 

Paul answers all electronic 
communications but is unable to 
respond personally to hard copy/disk 
messages. 


Q l enjoyed reading the October 1993 Q & A column. Your solution to the 
problem of finding a filename with a given handle involves intercepting 
I NT 21h. This opens a can of other problems, starting with the fact that Win¬ 
dows doesn't allow the interrupt to be changed. You solved this by patching 
the interrupt entry with a jump to your ISR, and making an unpatched stub to 
which you jump. 

After reading your column I tried out another approach. Instead of changing 
the protected-mode INT 21h interrupt handler, I changed the real-mode I NT 21h 
interrupt handler. This is possible because all file opening is done through the 
real-mode DOS INT 21h services. The real-mode getvector/setvector functions 
are called through the DPMI services. I wrote a simple program to check this 
out, and (at least for the DOS open function) it worked fine. My program con¬ 
sists of a DLL, built by a C file and an assembler file for the ISR (see Figure 1). 

One thing I didn't try was using the DPMI functions 204h and 205h to set the 
protected-mode interrupt vector. This may be a way around the problem you 
had with setting the interrupt through INT 21b, which Windows didn't allow. 

Ton Plooy 
commotio@marvels.hacktic.nl 

A You are absolutely right. Real-mode DOS is still used for handle-based file 
services, with Windows translating protected-mode addresses to real-mode 
addresses before invoking the real-mode DOS ISR. Your solution is much better 
than the one I presented in the October 1993 Q8A, especially since it does not 
depend on Windows 3.1 implementation details. 

I re-implemented the DLL component of my previous answer (notify.dll) 
using a small variation on the pseudo-code you present in Figure 1. The DLL 
now consists of notify.c (Listing 1), hook21. asm (Listing 2), and notify.def (Listing 
3). The change I made is to call the original real-mode ISR from the real-mode 
hook before calling the real-mode alias, instead of using the real-mode alias 
itself as the ISR hook (the real-mode alias is allocated from DPMI to provide an 
execution path from real to protected mode). This gives the real-mode hook a 
chance to examine the carry flag for success or failure. The protected-mode 
notification code is called through the real-mode alias only if the INT 21h was 
successful and is for one of the services of interest. Figure 2 illustrates the 
modified scheme. 

The new notify.c differs from its predecessor mainly in the routines Lib- 
MainO, and NEP(), as well as two new routines, DoNotify21() and LpvProtO. Also, 
the routine Hook21() is now implemented in assembly language in hook21.asm. 
Like the old version, the new LibMainO allocates space for the file information 
list, but that is where the similarity ends. After the allocation, the new LibMainO 
ensures that its code segment exists in conventional memory, so that Hook21(), 
which is now a real-mode INT 21h ISR hook, lies within real-mode address 
space. For simplicity, notify.dll uses the small memory model, and its single 
code segment is declared as FIXED in notify.def. When you use the FIXED attrib¬ 
ute for a DLL segment, Windows loads the segment into conventional memory 
and page-locks it, which is precisely what is needed for a real-mode ISR hook. 
The check at run-time to see if the code segment was indeed loaded into 
conventional memory is a bit of paranoia on my part, since I just don't trust 
the Windows loader to do the right thing in a low memory situation (i.e., abort 
the load if the DLL cannot be loaded low). 


Paul was a developer of HyperChem, a molecular modeling system, and more recently, 
of Creative Writer, a word processor for children. He works for Microsoft Corporation as 
a Software Design Engineer. The opinions expressed in this column are Paul's alone 
and not those of Microsoft. 





















Figure 1 Pseudo-code for revised INT 21H hook scheme 

catch.c: 

int21.asm 

Libmain(..) 

{ 

; handler is called with real mode register structure 

Read real node vector: // DPMI Int 31h, function 0200h 

int21handler 


cmp byte ptr es:[di + lDh], 3Dh ; File open 

Generate a writeable selector for the DLL code segment; 

jne ChainDos 

Write the real mode vector to the code segment (OrgProc); 

; Handle file open (The ds:dx file name is a real mode address, 

; we’re in protected mode now, so convert the address first). 

Allocate a real mode call-back address for 

the interrupt handler; // DPMI 31h, function 0303h 

ChainDos 


; Set CS:IP in register structure to segment:offset for 

Set real node vector: // DPMI int 31h, function 0201 

} 

; original handler 

mov ax, word ptr _0rgProc + 2 

mov word ptr es:[di + 2Ch], ax 

WEP(..) 

{ 

mov ax, word ptr _0rgProc 
mov word ptr es:[di + 2Ah], ax 

Restore the original real mode vector; 

} 

iret 


Figure 2 Modified INT 21H interception scheme 



Tired of juggling with your 
serial port problems? 

Losing serial characters because of 
Windows' interrupt latencies? Are your 
comm applications running unbearably 
slow? Juggling a little code here, fiddling 
with an ISR there, and trying again? 

There’s a better solution: 

COMMtelligence 7 

This RS232/RS485 board has a PC-compatible 
CPU dedicated to servicing interrupts from its 
four serial ports. Dual-port RAM, resident 
firmware, and 512K. of RAM provide deeply 
buffered serial data to your Windows or DOS 
program - with no missing data. 

To supercharge applications, download custom programs 
onto the COMMtelligence board to perform protocol 
conversion, polling, or other front-end processing tasks. 

So quit juggling with your serial port problems. Get your 
application going by calling or FAXing for details today. 




^DRUMLIN 


3447 Ocean View, Glendale, CA 91208 


Phone 

FAX 


(818) 244-4600 
(818) 244-4246 
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LibMainO converts the protected- 
mode address of the Hook21() routine 
into a real-mode paragraph:offset ad¬ 
dress, so that it can be installed as 
the new INT 21h ISR. Before installing 
Hook21(), however, the code first ob¬ 
tains the real-mode address of the 
current INT 21h ISR and writes this 
into the code-segment variable 
lpfnSav, using toolhelp's MemoryUriteO 
procedure. This allows Hook21() to 
chain to the original ISR without hav¬ 
ing to obtain the original INT 21h ISR 
address from a global variable in the data segment. 

If a global variable were used for lpfnSav, the DGROUP 
segment would have to reside in conventional memory, 
and a real-mode paragraph for it would have to be ob¬ 
tained and written to code space anyway, since a selector 
is useless in real-mode. LibMainO next obtains a real-mode 
alias for the protected-mode routine Notify21(). Real-mode 
code can call this address to request DPMI to first switch 
to protected mode then call the protected-mode routine. 

Since Notify21() will now be running in protected- 
mode, it is free to access data in the DLL's DGROUP segment. 
The real-mode alias for Notify21() is also written into code 
space, since Hook21() will need to call the address when an 
INT 21b request of interest is successfully carried out. The 
DPMI function to obtain a real-mode alias expects to be 
passed the address of a Real Mode Register (RMR) struc¬ 
ture (the rmr struct near the top of notify, c). Whenever 
Notify210 is called, it will be passed the address of the 
RMR via ES:DI. The structure will contain the values of the 
CPU's registers at the time the real-mode alias was called. 
When Notify21() returns, the CPU's registers will be re¬ 
stored from whatever values are in the RMR at that time. 
Notify210 is free to change ES-.DI to point to another RMR 
structure if required. 

Finally, LibMainO sets Hook21() as the new real-mode INT 
21h ISR. The stage has now been set to receive real-mode 
INT 21h requests. Whenever one occurs, Hook21() (in 
hook21.asnii is invoked, in real mode, to handle the inter¬ 
rupt. It is very important that Hook21() ensure that by the 
time it calls the original real-mode ISR, the registers contain 
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/* notify.c */ 
/* -- DLL tracks open files by hooking int 0x21. */ 
/* -- To build: */ 
/* cc -wd -DSTRICT notify.c libentry.obj \ */ 
/* hook21.obj toolhelp.lib notify.def */ 
/* implib notify.lib notify.dl1 */ 


#include <windows.h> 

♦include <windowsx.h> 

♦include <toolhelp.h> 

♦include "notify.h" 

/* Increment this many file info entries at a time. */ 
♦define dcofi 100 

/* Get more space when number of free entries hits */ 


/* this value. */ 

♦define cofiLow 50 

/* Internal prototypes. */ 

void CopyLpsz!LPSTR IpszDest, LPSTR IpszSrc); 

void Joadds DoNotify21 (LPWORD lpwStack); 

int CALLBACK LibMain(HINSTANCE hinsThis, WORD wDS. 

WORD cbHeap, LPSTR lpsz); 

OFI far * LpofiFind(int wHandle); 

LPVOID LpvProt(WORD wSeg, WORD wOff); 

void Hotify(void); 

void NotifyClose(int wHandle): 

void NotifyDuplicate(int wOrig, int wNew): 

void NotifyOpen(LPSTR IpszFile, int wHandle): 

WORD PdbGetCur(void); 

int CALLBACK .export WEPCint wExitCode); 


the same values as when Hook21() 
was first invoked. By the same token, 
when Hook21() returns, the registers 
must be restored to the state they 
were in just after the original 1SR re¬ 
turned. To this end, the procedure 
saves the INT 21h function number in 
a stack-based ([BP - 2]) variable, so 
that it can be examined after the 
original ISR is called (in most cases, 
after the ISR has been called, the 
value in AX will no longer contain the 
function number). The original flags 
are pushed before calling the ISR to 
simulate an interrupt. 

After the original INT 21h ISR re¬ 
turns, Hook21 () first checks the carry 
flag. If it is set, the code jumps to the 
exit point, since for any of the INT 
21h functions of interest, a set carry 
flag indicates failure. If the flag is not 
set, the code scans an array (also in 
the code segment) of the function 
numbers of interest against the func¬ 
tion number stored in [BP - 2], If no 
match is found, the code jumps to 
the exit point. If a match is found, No- 
tify21() is called via the real-mode 
alias, and passed the function num¬ 
ber in [BP - 2], 

Notify21(), another assembly lan¬ 
guage routine, is a small cover func¬ 
tion that gathers register-based argu¬ 
ments and calls the C routine Do No¬ 
ti fy21(). When the DPMI host calls 
Notify21 (), DS:SI contains the pro- 
tected-mode address corresponding 
to the real-mode stack. Notify21() 
pushes this address as the single pa¬ 
rameter to DoNotify21(). DoNotify21() 
has been declared as Joadds, so the 
compiler will emit code at the start of 
the function to set DS to the DLL's 
DGROUP. I could have declared the 
function as _ export , but this would 



for C/C++ 

presents Bug # 785 


#include <stdio.h> 

class complex 
{ 

public: 

double real, imag; 

operator double!) { return real + imag; } 

}; 

complex x; 

int main() 

{ 

x.real = 1.0; x.imag = 1.0; 
complex cc[2] = { x, x }; 

printf( "%g %g \n", cc[0].real, cc[l].real ); 
return 0; 

} 

HHHI : ———— - 


Instead of printing "1 1" as expected, this program prints "2 0". Why? 
Call if you need a hint. Refer to Bug #785. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Numerous C++Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new's matched by your 
destructor delete’s? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much, more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans, 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 


Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

Options Galore: A plethora of options for 
message suppression, message format, 
compiler dependencies, etc. All messages 
can be individually suppressed or enabled, 
both locally and globally. Numerous 
compilers/ libraries supported. Runs on 
MS-DOS (Optional built-in 386 DOS 
extender) and OS/2. 

PC-lint for C $139 
PC-lint for C/C++ $239 

PC-lint users: call for update pricing 
Unix and Mainframe programmers: 
call for pricing for FlexeLint. 



3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610)584-4266 

30 Day Money-back Guarantee. 

PA add 6% sales tax. PC-lint and FlexeLint are trademarks of Gimpel Software 
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Listing 1 continued 


1 

HWND hwndNotify; /* Notify when list changes. */ 

} 


OFI huge * gprgofi; /* File info list. */ 

long cofi; /* Size of list. */ 

int CALLBACK .export WEP(int wExitCode) 


long cofiUsed: /* Number of files in list. */ 

/ ***************************************************** / 


BOOL fNotified; /* Client has been notified. */ 

/* -- Remove the int 21 ISR hook. */ 


WORD sel; /* Allocated selector. */ 

/*****************************************************/ 


struct 

{ 


{ 

_asm mov ax. 0x0201; /* Restore previous ISR. */ 


WORD wDI, wEDIHi, wSI. wESIHi, wBP. wEBPHi; 

_asm mov bx. 0x0021; 


DWORD lwReserved; 

_asm mov dx, WORD PTR cs:[lpfnSav]; 


WORD wBX, wEBXHi, wDX, wEDXHi, wCX, wECXHi, 

_asm mov cx, WORD PTR cs:[lpfnSav + 2]; 


WAX, wEAXHi, wFlags. wES. wDS, wFS, wGS, 

_asm int 0x31; 


wIP, wCS, wSP, wSS; 

} rmr; /* Real-Mode Registers. */ 

/* Free real-mode alias. */ 


/* Store these addresses in code so real-mode code */ 

_asm mov ax, 0x0304; 

_asm mov dx. WORD PTR cs:[lpfnAlias]; 


/* can access them without requiring a data segment. */ 

_asm mov cx, WORD PTR cs:[lpfnAlias + 2]; 


FARPROC _based(_segname("_CODE")) lpfnAlias; 

_asm int 0x31; 


FARPROC _based(_segname("_CODE")) lpfnSav; 

int CALLBACK LibMain(HINSTANCE hinsThis, WORD wDS. 

if (gprgofi != NULL) /* File info list. */ 

GlobalFreePtr(gprgofi); 


WORD cbHeap, LPSTR Ipsz) 

if (sel != 0) /* Addr. xlate selector. */ 


/*****************************************************/ 

FreeSelector(sel); 


/* -- Install the int 21 ISR hook, save the old */ 

/* contents. */ 

return 1; 


/*****************************************************/ 

{ 

int wVal =0; /* Outcome. */ 

} 


void Joadds DoNotify21 ( LPWORD lpwStack) 


DWORD lw, lpfnReal; 

/*****************************************************/ 


FARPROC lpfnProt = ( FARPROC)Hook21; 

/* -- Protect mode callback from real-mode calls */ 


/* Preallocate some space for the file list. */ 

/* appropriate notification routine to deal with */ 

/* current interrupt 0x21. */ 


cofiUsed = 0; 

/* -- lpwStack : Protect mode address corresponding */ 


if ((gprgofi = G1obalA11ocPtr(GMEM SHARE | GHND, 

/* to real mode stack. */ 


(cofi = dcofi) * sizeof(OFI))) == NULL) 

/***************************************************** j 


return 0; /* No memory. */ 

{ 


lpfnReal = GetSelectorBase(SELECTOROF(lpfnProt)); 

/* Fix up return address (CS:IP) in real mode */ 

/* register data structure. *1 


if (lpfnReal > 0x00100000 II /* Loaded low? *7 

rmr.wIP = 1pwStack[0]; 


lpfnReal & 0x0000000f) /* Para boundary? */ 

rmr.wCS = lpwStack[l]; 


return 0; /* Can't use code segment. */ 

rmr.wSP += 4; /* Simulate a far return. */ 


_asm push si; /* Save some registers blown */ 

/* Call the appropriate notification handler. */ 


_asm push di; /* away by ensuing _asm code. */ 

switch (HIBYTEdpwStack[2])) 

{ 

default: /* Should never happen. */ 


lpfnReal = ((lpfnReal & 0x000ffff0) « 12) + 


OFFSETOF(lpfnProt); /* Get real-mode addr. */ 

break; /* Should have an assert here. */ 


_asm mov ax, 0x0200; /* Save original real- */ 

case 0x3c: 


_asm mov bx, 0x0021; /* mode int 0x21 ISR. */ 

case 0x3d: 


_asm int 0x31; 

case 0x5a: 


_asm mov WORD PTR [lw], dx; 

case 0x5b: 


_asm mov WORD PTR [lw + 2], cx; 

NotifyOpen(LpvProt(rmr.wDS. rmr.wDX), rmr.wAX); 


MemoryWrite ( SELECT0R0F(&1pfnSav ) , OFFSETOF(ilpfnSav), 

break; 


&lw, sizeof lw); 

_asm mov ax, 0x0303; /* Get a real-mode alias */ 

case 0x3e: 

NotifyClose(rmr.wBX); 


_asm push ds; /* for the real-mode int */ 

break; 


_asm pop es; /* 0x21 handler to call */ 

_asm mov di, OFFSET rmr; /* back to. */ 

case 0x45; 


_asm push ds; 

NotifyDuplicate(rmr.wBX, rmr.wAX ); 


_asm push cs; 

break; 


_asm pop ds; 

_asm mov si. OFFSET Notify21; 

case 0x46: 


_asm int 0x31 

NotifyDuplicate ( rmr.wCX, rmr.wBX ); 


_asm pop ds; 

break; 


_asm jc LCleanup; 

_asm mov WORD PTR [lw], dx 

case 0x6c: 


asm mov WORD PTR [lw + 2], cx 

NotifyOpen(LpvProt(rmr.wDS. rmr.wSI), rmr.wAX); 


MemoryWrite(SELECT0R0F(&1pfnAlias ) . 

break; 


0FFSET0F(&1pfnAlias ) , &lw. sizeof lw); 

} 

} 

LPVOID LpvProt(WORD wSeg, WORD wOff) 


/* Get a selector/descriptor for obtaining */ 

/* protect mode addrs. from real-mode addrs. */ 


if ((sel = A1locSelector(wDS) ) == 0) 

/*****************************************************/ 


goto LCleanup; 

/* -- Return the protect mode address corresponding */ 


SetSelectorLimit(sel, 0x0000ffff); 

/* to the given real-mode address. */ 


_asm mov ax, 0x0201; /* Install our real-mode */ 

/* -- Uses the pre-al 1 ocated selector, so this call */ 

/* cannot be re-entered. */ 


_asm mov bx, 0x0021; /* int 0x21 handler. */ 

/*****************************************************/ 


_asm mov dx, WORD PTR [lpfnReal]; 

{ 


_asm mov cx, WORD PTR [lpfnReal + 2]; 

SetSelectorBase(sel, (DWORD)wSeg * 0x10); 


_asm int 0x31; 

return MAKELP(sel, wOff); 


_a$m jc LCleanup; 

} 


wVal = 1; /* Success! */ 

void NotifyOpen ( LPSTR lpszFile, int wHandle) 


LCleanup: 

/*****************************************************/ 

/* -- Add the file to the list and notify the client */ 


_asm pop di; 

/* the list has changed. */ 


_asm pop si; 

/*****************************************************/ 


return wVal ; 

{ 
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Listing 1 continued 


long iofi; 

gpofi++. iofi++) 

OFI huge * gpofi; 

if (gpofi->pdb == 0) 

WORD pdb = PdbGetCurO; 

{ 

/* Add info to list. */ 

if (cofi == cofiUsed) 

gpofi->wHandle = wHandle: 

return; /* Out of space. */ 

CopyLpsz(gpofi->szPath, IpszFile); 
gpofi->pdb = pdb; 

/* Check for duplicates. */ 

cofiUsed++; 

for (iofi = 0, gpofi = gprgofi; iofi < cofiUsed; 

NotifyO; /* Inform client. */ 

iofi += (gpofi++)->pdb != 0) 

break; 

if (gpofi->pdb == pdb && 

j 

gpofi->wHandle == wHandle) 
return; /* Duplicate. */ 

} 

WORD PdbGetCur ( void) 

/* Find a free slot in the list. */ 

/*****************************************************/ 

for (iofi = 0. gpofi = gprgofi; iofi < cofi; 

/* -- Return the current PDB. */ 


really be overkill since, in addition to 
causing DS to be loaded, the _export 
keyword causes the function name to 
be placed in the non-resident names 
table to support dynamic linking. 
Since DoNotify21() is a private func¬ 
tion, exporting is unnecessary. 

Notify21() does not bother to pass 
the address of the RMR to DoNo- 
tify21(), since the RMR is a global 
structure in the DLL's DGROUP. You 
might think that this would create a 
problem, since as ! pointed out in the 
October 1993 Q9A, INT 21h is re-en¬ 
trant (for example, INT 21h, function 
4Ch, terminate program, issues INT 
21h, function 3Eh to close each open 
file). Even though the INT 21h ISR is 
re-entrant, DoNotify21() is not, since 
Hook21() has been designed to re¬ 
curse at the start of the routine. It 
only calls Notify21() after chaining to 
the original ISR, which is where the 
re-entrance would occur. DoNotify21() 
can call NotifyOpenO, which in turn 
calls PdbGetCurO, which issues an INT 
21h, function 51h to obtain the current 
PDB. This would be a problem if 
function 51h were in the list of func¬ 
tions of interest, but it's not, so 
Hook21() will not re-enter Notify210 in 
this case. Life in the real world is not 
always so simple, however, and if 
you do write a protected-mode rou¬ 
tine with a real-mode alias that can 
be re-entered, you will not be able to 
use a global RMR. In this case you 
will have to dynamically allocate 
RMRs or manage an array of them 
and limit your recursion to the size of 
the array. 

DoNotify21()'s first task is to fix up 
the return address in the RMR. It 
does this by copying the return 
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Listing 1 continued 


I ***************************************************** j 

{ 

WORD pdb; 

_asm mov ax, 0x5100 

_asm int 0x21 

_asm mov pdb, bx; 

return pdb; 

} 


void Notify(void) 

/*****************************************************/ 
/* -- Post notification that file list has changed. */ 
/*****************************************************/ 
{ 

if (IsWindow(hwndNotify)) 

{ 

if (!fNotified) 

{ 

fNotified = TRUE; 

PostMessage(hwndNotify, WMJJSER, 0, 0); 

} 

} 

else 

hwndNotify = NULL; 

} 


void CopyLpsz(LPSTR IpszDest, LPSTR IpszSrc) 


/* -- Our own version of IstrcpyO, since it needs 
/* to be called at interrupt time. 


{ 

while ((*lpszDest++ = *lpszSrc++) != 0) 

} 


void NotifyClose(int wHandle) 

I *****************************************************/ 

/* -- Remove the file from the list and notify the */ 
/* client the list has changed. */ 

/A****************************************************/ 

{ 

OFI far * lpofi; 

/* See if the file is on the list. */ 
if ((lpofi = LpofiFind(wHandle)) != NULL) 

{ 

/* Remove from list. */ 
lpofi->pdb = 0; 
cofiUsed--; 

NotifyO; /* Inform client. */ 

} 

} 


OFI far * LpofiFind(int wHandle) 

I ***************************************************** j 

/* -- Find the file handle for the current task. */ 
/* -- Return NULL if not found. */ 

/A****************************************************/ 

{ 

long iofi; 

OFI huge * gpofi; 

WORD pdb = PdbGetCurO; 

for (iofi = 0, gpofi = gprgofi; iofi < cofiUsed; 
iofi += (gpofi++)->pdb != 0) 
if (gpofi->pdb == pdb && 
gpofi->wHandle == wHandle) 
return gpofi; 

return NULL; 

} 

void NotifyDuplicate(int wOrig, int wNew) 
/*****************************************************/ 
/* -- Add the duplicate handle to the list. */ 

/*****************************************************/ 
{ 

OFI far * lpofi; 

/* See if the file is on the list. */ 
if ((lpofi = LpofiFind(wOrig)) != NULL) 
NotifyOpendpofi->szPath, wNew); 

} 

void WINAPI .export SetPostWnd(HWND hwnd) 

/*****************************************************j 

/* -- Set the window to receive notifications. */ 
/*****************************************************/ 
t 
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Listing 1 continued 

hwndNotlfy ■ hwnd; 

(cofi + dcofi) * sizeof(OFI), 

) 

GMEMJHARE 1 GHND) ) 1= NULL) 

BOOL WINAPI .export FNextOfi(OFI far * lpofi, 

gprgofi = gprgofiNew; 

long far * lpiofi) 

cofi += dcofi; 

/***************************************************** j 

i 

/* -- Client service. */ 

} 

/* -- Return the next file in the list to the */ 

i 

/* client. */ 


/* -- Call with ‘lpiofi set to -1 to begin */ 

/* Is the list empty? */ 

/* enumeration. */ 

if (cofiUsed == 0) 

/* -- Updates lpiofi to next entry each call, */ 

return FALSE; 

/* returns FALSE once all entries have been */ 


/* enumerated (in which case *lpofi is invalid). */ 

/* Find the next file. */ 

/*****************************************************/ 

for (++*1piofi; *lpiofi < cofi; ++*lpiofi) 

t 

if (gprgofi[*lp1ofi ] .pdb != 8) 

if (fNotified) 

{ 

t 

*lpofi = gprgofi[*lpiofi]; 

fNotified = FALSE; /* Ok to notify again. */ 

return TRUE; 

/* Grow list? */ 


if (cofi - cofiUsed < cofiLow) 

return FALSE; 

OFI huge * gprgofiNew; 

/* End of File */ 

if ((gprgofiNew = GlobalReAllocPtr(gprgofi, 



address on the real-mode stack to the RMR's CS and IP 
registers. The RMR's SP register is incremented by 4 to 
simulate a far return. If the real-mode alias had been used 
directly as the address of an ISR, as in your pseudo-code 
in Figure 1, the SP would need to have been incremented 
by 6 to simulate an IRET instruction. DoNotify21() then 
switches on the function number (obtained from the real¬ 
mode stack) and calls either NotifyOpenO, NotifyDupli- 
cateO, or NotifyCloseO to generate the appropriate notifi¬ 
cation (the implementation of these three routines is the 
same as in the October 1993 column). 

As Ton pointed out in the pseudo-code, far real-mode 
addresses need to be converted to selector:offset ad¬ 
dresses before they can be used in protected mode. This 
can be accomplished by allocating a selector, setting its 
linear base address to 16 times the value of the real-mode 
pointer's paragraph portion, and setting its limit to the 
largest addressable offset required. The selector can be 
obtained from DPMI, using function 0000h, or from the 
Windows function AllocSelectorO. Instead of allocating a 
selector on each call to DoNotify21(), I allocate just one in 
LibHalnO and re-use it each time DoNotify21() is called (the 
DLL's HEP() frees the selector with a call to FreeSelectorO). 

The function LpvProtO is used by DoNotify21() to con¬ 
vert the real-mode address of a file name to a protected- 
mode address. LpvProtO calls SetSelectorBaseO to change 
the selector's base address. The selector's limit was set to 
64Kb just after it was allocated in LibHainO. This is the 
largest offset possible in a far pointer (either real or pro¬ 
tected mode), so there is no need to set the limit each 
time LpvProtO is called. It is worth pointing out that the 
values used for SetSelectorBaseO and SetSelectorLimitO 
are expressed in different units. SetSelectorBaseO takes the 
linear address that the start of the selector will address. 
SetSelectorLimitO sets the largest addressable offset for 
the selector, not the linear address limit. So, for example, 
if a selector's linear base address has been set to 
0x00010000, and its limit is 0x00001000, then protected mode 


addresses in the range [sel:0000, sel:0fff] map to linear 
addresses in the range [0x00010000, 0x00010fff]. 

SetSelectorBaseO is equivalent to the DPMI function 
0007lr, SetSelectorLimitO is equivalent to DPMI function 
0008h; and FreeSelectorO is equivalent to DPMI function 
0001h. As Matt Pietrek notes in his book, Windows Internals 
(Addison-Wesley, 1993), these Windows functions play 
with the local descriptor table directly, instead of calling 
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Listing 2 hook21.asm — Real-mode INT 21H ISR 
hook 


hook21.asm 

-- Real-mode Int 21 ISR hook. 

-- To assemble: "masm -Mx -Zi hook21.asm;" 


.286p 

NOTIFLTEXT SEGMENT WORD PUBLIC ’CODE' 

ASSUME CS: NOTIFYJEXT 
PUBLIC _H00k21 
PUBLIC _Notify21 

EXTRN _DoNot1fy21:NEAR ; C procedure. 

EXTRN JpfnAlias:NEAR ; Code-space variables. 
EXTRN _1pfnSav:NEAR 

_Hook21 PROC NEAR 


Real-mode int 21h handler chains to original 
handler. 

Parameters: 

-- [bp + 06h] ; Flags. 

Locals: 

-- [bp - 02h] : Int 21h function number. 


push bp 

mov bp, sp 

sub sp. 02h 

mov [bp - 02h], ax : Function number. 

; Let original ISR handle interrupt. 

push [bp + 06h] ; Original flags. 

call dword ptr cs:[_lpfnSav] ; Chain. 

pushf ; Save new flags for 

pop [bp + 06h] ; terminal iret. 

jc LSkipNotify 

; If function was one of those we are interested 


the DPMI host, since calling DPMI takes too much time. 
But they must be used with care. The big problem is in 
the implementation of FreeSelectorO and the higher level 
global memory functions. 

When a block of global memory greater than 64Kb is 
allocated, Windows allocates a contiguous block of local 
descriptors to address each consecutive 64Kb chunk of lin¬ 
ear memory. This is referred to as selector tiling, and it is 
the mechanism behind huge pointer manipulation. The 
problem is that FreeSelectorO assumes the selector being 
freed was allocated by the global memory manager. The 
routine obtains the selector's limit, divides it by 64Kb to 
get the number of tiles, and frees the corresponding block 
of selectors in the LDT. The code does not take into ac¬ 
count the fact that the selector's limit may have been set 
by SetSelectorLimitO to address a block of memory 
greater than 64Kb. 

I found this out the hard way. In my case, FreeSelec¬ 
torO freed not only the selector I passed in, but also both 
my code and another application's data segment selec¬ 
tors! This resulted in an amazing series of UAEs, a hard 
lockup of my computer, and lots of debris left lying 
around on my hard drive for chkdsk to clean up. The 
moral of this story is that if you do use these Windows 
selector functions to set a limit greater than 64Kb, make 
sure you set the limit back under 64Kb before calling 
FreeSelectorO. 

That pretty much wraps it up for the new, improved ver¬ 
sion of notify.dll. All the other functions are unchanged 
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from the first version. The filelist.exe application that re¬ 
ports the current open files only needs to be relinked with 
the new import library, notify, lib. 

Now to address the second part or your letter. It turns 
out that DPMI functions 0204h and 0205b do indeed bypass 
the problems caused by using INT 21h functions 25h and 
35h to set the protected-mode INT 21h handler. But the 
problem remains that Windows calls the protected-mode 
INT 21h ISR directly, either inline or through D0S3Call(). So 
a protected-mode INT 21h ISR installed into the IDT using 
DPMI will miss most of the calls Windows makes to the 
original protected-mode INT 21h ISR; it will only see true 
software interrupts from an INT 21h instruction. 

Q I just saw the October 1993 issue of W/DDJ with 
your column on hooking INT 21h. While doing the 
WISPY (I Spy for Windows) program for Undocumented 
Windows, I ran into similar problems with a conventional 
hook of INT 21h, but I found that the GetSetKernelDOSProcO 
function (see Undocumented Windows, pp. 271-73, and p. 
188) worked like a charm. Did you have a chance to look 
at GetSetKernelDOSProcO ? I ask because there is one very 
confusing thing about it: it seems to see absolutely all INT 
21b calls, except INT 21h AH=4Bh (EXEC). To see EXEC calls 
(e.g., from UinExecO), I had to do a conventional INT 21h 
hook. Can you shed any light on why GetSetKernel¬ 
DOSProcO doesn't see EXEC calls? 

Andrew Schulman 
CIS: 76320,302 

A I have received more feedback on that October INT 
21h answer than anything else to date! This is a clear 
indicator of both the complexity of the subject and the 
lack of good documentation describing how interrupts 
work in Windows. 

There are many locations in Windows where INT 21h 
handlers can be installed. In the previous question, Ton 
Plooy showed that it's better to use DPMI to hook both 
the real- and protected-mode handlers than to use the INT 
21h get and set interrupt vector functions (35h and 25h). 
When an INT 21h is issued from protected mode, first the 
protected-mode handler is invoked, then, after some inter¬ 
mediate processing, the real-mode handler is invoked for 
some, but not all, of the INT 21h functions. 

After peering at Windows through the debugger, I was 
able to determine that the interrupt handler installed by 
GetSetKernelDOSProcO is invoked during the "intermediate 
processing.' The default handler is really an entry point to 
the VMM layer, in particular the DOS Manager VxD, 
DOSMGR. DOSMGR is responsible for reflecting the inter¬ 
rupt to real mode, and performing the necessary address 
translations for those INT 21h functions that require point¬ 
ers. 

So the path of an "ordinary" protected mode INT 21b, 
say function 3Dh (open file), goes something like this: 

7. Interrupt is issued. 

2. CPU gets address of handler from IDT and transfers control to 
protected-mode handler. 


Listing 2 continued 


; In, call the real-mode alias to deal with it. 
pusha ; Save state, 
push es 

push cs ; Prepare for function number scan. 

pop es ; es:di <-- function number array. 

mov di, offset rgbFuncs 

mov cx, (pbfuncsLim - rgbFuncs) ; Array size. 

mov al, byte ptr [bp - Olh] ; Function number. 

repne scasb 

pop es 

popa 

jnz LSkipNotify ; Was it in the array? 

push [bp - 02h] ; Yes, so notify client, 

call dword ptr cs:[JpfnAlias] 

; Should have an "add sp, 02h" here, but why bother 
; since we are about to remove the stack frame. 

LSkipNotify: 
mov sp, bp 
pop bp 
iret 


rgbFuncs: 


Array of intersting function numbers. 

db 

3ch 

Create. 

db 

3dh 

Open. 

db 

3eh 

Close. 

db 

45h 

Duplicate. 

db 

46h 

Force duplicate. 

db 

5ah 

Create temp. 

db 

5bh 

Create new. 

db 6ch 
pbFuncsLim: 
_Hook21 ENDP 

Extended open/create. 


_Notify21 PROC NEAR 

;; -- Protect mode callback from real-mode calls 
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Listing 2 continued 


; appropriate notification routine to deal with ; 

; current interrupt 21h. ; 

; -- Input: 


: - DS:SI 

Prot mode address corresponding to ; 
real mode SS:SP. : 

; - ES:DI 

Protect mode address of real-mode : 
call structure. : 

push es 

; Preserve real-mode struct selector. 

push ds 

; Pass far pointer to real mode stack. 


push si 

call _DoNotify21 ; Do all the work in C. 
add sp, 04n 
pop es 
iret 

_Notify21 ENDP 

NOTIFYJEXT ENDS 
END 

; End of File 


3. Protected-mode handler does some preprocessing, looks up 
address of DOSMGR entry point, and calls entry point 

4. DOSMGR performs any necessary address translation, and 
reflects the interrupt to real mode, calling the real-mode INT 
21h handler from the IVT. 

5. The real mode handler does its thing. 

A handler installed by GetSetKernelDOSProcO will get 
control between steps 3 and 4. So why does such a han¬ 
dler not get called for function 4Bh ? In this case, the pro¬ 


tected-mode handler completely handles the interrupt and 
does not pass the interrupt through to real mode. The 
handler uses LoadModuleO and/or LoadLibraryO to do its 
work. 

This raises an interesting question, if the loading of a 
Windows program is handled completely in protected 
mode, why use INT 21h function 4Bh at all? Why not sim¬ 
ply move the INT 21h function 4Bh handler into UinExecO? I 
can only speculate here, but i suspect it may be some 
kind of compatibility hack. It is conceivable that some Win 
2.x application used INT 21h function 4Bh instead of Uin¬ 
ExecO to launch other Windows applications. If the INT 
21b function 4Bh handler did not exist, and the interrupt 
were reflected to real mode, such a program would fail to 
load, since DOS would only recognize the real-mode stub. 
It would be rather disconcerting to see the message "This 
program requires Microsoft Windows' when trying to run 
a Windows program from within Windows! 

There are a couple of interrupt-related functions I 
should discuss for completeness: the documented 
D0S3Call() API function, and NoHookDOSCallO, from page 
339 of Undocumented Windows. D0S3Call() calls the pro- 
tected-mode INT 21h handler directly, via a hard-wired ad¬ 
dress, and therefore does indeed behave as if an INT 21h 
were directly executed. NoHookDOSCallO calls the DOSMGR 
entry point via its address (obtained from the location at 
offset 0x3C in the KERNEL code segment containing the 
protected mode INT 21h handler), the same address that 
GetSetKernelDOSProcO modifies directly, bypassing the pre- 
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processing of the protected-mode handler. So it would not 
be a good idea to call NoHookDOSCallf) with function 4Bh to 
load a Windows program. 

Q l just installed DOS 6.2 and was really impressed 
with how the Undelete, Virus Check, and Backup 
programs interact with Windows. The question is, how do 
I modify the File Manager menu so that my file utility pro¬ 
grams can be called from there? 

Dennis R. Fischer 
CIS: 70405,1422 

A Customizing the File Manager menu is documented in 
the SDK Programmer's Reference, vol. 1, chapter 16, 
'File Manager Extensions.' There is also a sample program 
on the MSDN CD entitled 'XTENSION.' The basic mecha¬ 
nism involves adding to the '[Addons]' section of the File 
Manager's winfile.ini a line that names the location of a 
DLL providing the extensions. In the case of the DOS 6.0 
tools, the section looks like (note the spelling of 'exten¬ 
sions'!): 

[AddOns] 

MS-DOS Tools Extentions=C:\D0S\MST00LS.DLL 

Your DLL must export a function named FMExtension- 
ProcO, and must contain the extension menu resource. 
FMExtensionProcO is called by File Manager in response to 
various events (extension menu initialization, extension 
DLL load and unload, file-selection change, and user-re¬ 
quested refresh). In addition, FMExtensionProcO can query 
the File Manager by sending File-Manager-specific window 
messages to get: current drive information, the selected 
file, the File Manager window with the focus, and the file 
selection count. Two other messages specify commands 
that will cause File Manager to refresh its windows and to 
reload its extension DLLs (this is useful when an extension 
DLL wishes to remove itself). 

Q l am writing to you about your SYMEDIT program 
[May '93 Q&A[, which I have downloaded from 
ftp.uu.net. I am very interested in it because it may be a 
way to build a double-byte extension for Windows. 1 have 
one problem: when I launch symedit.exe and then start a 
windowed DOS box, in that DOS box I get some colorful 
spots. I would be very grateful if you could provide some 
help about using the hook algorithm with the DOS box. 

Tian Bogang 
Milan, Italy 
cbogang@iciI64.cilea.it 

A symedit.exe was a program I wrote in response to a 
reader's desire to display two different fonts in a sin¬ 
gle standard edit control. The technique I used involved 
intercepting Windows API calls made by the edit control 
and tinkering with their parameters, a technique not for 
the faint-hearted. You have indeed found a problem with 
this code - I need a test department! 


Listing 3 notify.def — Module definition file for 
notify.dll 


notify.def 

— Linker module definition file for notify.dll. 


LIBRARY 

notify 

DESCRIPTION 

’Notify module definition file’ 

EXETYPE 

WINDOWS 

CODE 

PRELOAD FIXED 

DATA 

PRELOAD MOVEABLE SINGLE 

HEAPSIZE 

4096 

EXPORTS 

WEP 

@1 RESIDENTNAME 


The culprit turns out to be the toolhelp API function 
MemoryMriteO. The macro HookHksO uses this function to 
both install and remove the jump instruction (to the hook 
function) placed at the beginning of the hooked routine. 
The problem is that MemoryMriteO is trashing the high 16 
bits of EDI (the 32-bit version of the DI register), a very 
unfriendly thing to do, since by convention, called func¬ 
tions are supposed to preserve DI and SI. And given the 
ever-increasing popularity of 32-bit applications, the tool- 
help API should preserve the high 16 bits as well. 

The reason this shows up in a windowed DOS box is 
that the Grabber (the Windows component responsible for 
maintaining the DOS box window) is reading the DOS 
box's virtual screen memory, and calling ExtTextOutO to 
display each line of text in the client area. The virtual 
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screen memory is obtained from a selector that spans the 
entire linear address space. The Grabber needs a 32-bit 
value to address this space, and so uses EDI, in the expec¬ 
tation that it will be preserved by the calls it makes to 
GDI. 

The fix is to rewrite the HookHksO macro, and to explic¬ 
itly save and restore registers around the call to Memory¬ 
UriteO. A revised version of HookHksO (I decided to make 
it a routine since it is no longer a single line of code) is in 
hookhks.c (Listing 4). It uses the pusha and popa instructions 
to save and restore the general purpose registers. If the 
code is running on a 386 or better processor, the instruc¬ 
tions are prefixed with the code byte 0x66. This is a width- 
override prefix that toggles the current operand width 


from 16 to 32 and vice versa. Since the code is running in 
a 16-bit segment, the prefix toggles the pusha and popa 
instructions to be the 32-bit variants, namely pushad and 
popad. 

Just in case you need to be able to run the code on a 
286 processor, I added tests of the external flag f286 just 
before executing the pushad and popad instructions. If the 
flag is true, the prefix bytes are skipped. I have not veri¬ 
fied if MemoryUriteO trashes DI on a 286 machine, but it 
does trash EDI on a 386 running in standard mode. You 
can initialize this flag in LibMainO with the following code: 

f286 = GetWinFlagsO & WF_CPU286; 

This is probably overkill on my part; 
since I have only seen MemoryUriteO 
trash the high 16 bits of EDI, I be¬ 
lieve that on a 16-bit 286 machine, 
there is likely no problem. 

Q l have encountered a problem 
in using Borland's Pascal v7.0 
(with the update installed) under Win¬ 
dows 3.1. The problem is that under 
BP7.0, the keyboard focus handler 
(i.e., EnableKbHandlerf)/SetKbHandler()) 
does not appear to be functioning 
properly. When I toggle back to my 
program (usually by using the Alt- 
Tab) after switching to another appli¬ 
cation, the tab key does not work. 

I originally wrote this program un¬ 
der TPW 1.5 and the program func¬ 
tions properly. In simple terms, the 
program creates a main window, 
then creates a 'desktop' window, 
and finally invokes a dialog window. 
The purpose of the desktop window 
is to be the parent of the dialog win¬ 
dows so that the dialogs do not in¬ 
fringe upon the areas reserved for 
the toolbar and status windows. 

I have contacted Borland Techni¬ 
cal Support and provided the techni¬ 
cal support person I talked to with 
the sample program. He informed 
me that the code should function the 
same under TPW 1.5 and BP7.0 and 
that he was turning it over to the 
programmers and that I should be 
hearing from Borland within several 
weeks. It has been about six months 
and my follow-up faxes to Borland 
have also gone unanswered. 

As it appears that neither a solu¬ 
tion nor any help will be forthcoming 
from Borland, I would appreciate any 
help that either you or anyone else 
at Windows/DOS can provide me. I 


ADVANCED 
SOLUTIONS 
FOR C/C++ 
PROGRAMMERS 


If you program in C/C++ you need the 
solution-oriented information found only 
in The C Users Journal. We devote 12 
issues every year to the language of 
choice, C/C++. Each issue is crammed 
with information on ANSI C, C+ + , 
debugging, tutorials, code, and more. 

A FREE issue of The C Users Journal 

is yours-call now and ask for a trial 
subscription. If you like the code-inten¬ 
sive C/C+ + programming solutions you 
find in your FREE issue, pay only $29.95 
for a full year’s subscription. If not, write 
‘cancel’ on the accompanied invoice 
and owe nothing. There’s NO RISK and 
NO OBLIGATION. 



Try a 

FREE ISSUE 


The 



Users Journal’ 


1601 West 23rd Street, Suite 200 
Lawrence, KS 66046 USA 


CALL: 913-841-1631 
FAX: 913-841-2624 


Non U.S. orders must prepay ($46 Canada/Mexico, $65 outside North America) in U.S. funds. 


Page 72 — Windows/DOS Developer’s Journal 


April 1994 

















am open to any solutions, suggestions, or alternate ap¬ 
proaches that you have, as I'm not sure where else to 
turn for help. 

Richard Rosenheim 
rrose@indirect.com 

A This appears to be a bug in BP v7.0. The problem 
originates inside BP v7.0's default message handler. If 
you have not written code to handle a particular message, 
the BP v7.0 runtime passes it to this default handler. Like 
DefUindowProcO, each message handled has its own block 
of code. In the case of wmActivate (corresponding to the 
Windows UM_ACTIVATE message), where the wParam indicates 
if the window is being activated (wParam is non-null) or los¬ 
ing the activation (wParam is NULL), the corresponding block 
of code in the default handler sets up some global vari¬ 
ables in response. In particular, there is a global variable 
that contains the address of an internal structure used to 
hold message-related information. 

When a dialog is present, BP v7.0's internal GetMes- 
sageO loop will call IsDialogMessageO if the value in the 
global is not NULL. It is IsDialogMessageO that is responsible 
for moving the focus to a new control when the user 
presses the tab key. As you may have guessed, your prob¬ 
lem is that IsDialogMessageO is not getting called, and the 
reason is that the global pointer variable is indeed NULL. 

The wmActivate code in the default handler looks at the 
value of wParam, and if it is NULL, sets the address of the 
message-related structure into the pointer; if wParam is non- 
NULL, the code sets the pointer to NULL. The problem is that 
this is backwards. My guess is that the developer at Bor¬ 
land who wrote the wmActivate code inverted the condition 
for testing wParam. The amazing thing is that this bug made 
it through their QA department. 

Fortunately, I think you can work around this bug. For 
each top-level window, add a wmActivate method, and if 
wParam is not NULL, call DefUndProcO with wParam set to NULL. 

After sending this answer to Mr. Rosenheim, I received 
a reply back from him that my solution did fix his prob¬ 
lem. The code he ended up using is: 

procedure AppWindow.wmActivate( 
var Msg : TMessage); 
begin 

if (Msg.wParam <> WAJNACTIVE) 
then begin 
Msg.wParam := 0; 

DefWndProc(Msg); 

end 

end; 

□ 


Listing 4 hookhks.c — New hook utility function 


^ ***************************************************** j 

I* hookhks.c */ 

/* -- Function sets or clears a jump instruction in */ 
/* a hooked function. */ 

j *******★★*★★★*★***★★*★**★****★★**★*******★**★******★★/ 

extern BOOL f286; 

void HookHks(HKS *phks, BOOL fHook) 

/***************************************************** j 

/* -- Hook out (or restore) the given function. */ 
/* -- Save and restore general purpose registers, */ 

/* since MemoryWrite() will trash them. */ 

/***************************************************** j 
( 

if (f286) 

goto LPusha: 

_asm _emit 0x66; /* pushad */ 

LPusha: 

_asm _emit 0x60; 

MemoryWrite(SELECTOROFCphks->1 pfnOr i g), 
OFFSETOF(phks->lpfnOrig), 
fHook ? &phks->bJump : phks->rgbCode, 
sizeof phks->rgbCode); 

if (f286) 
goto LPopa; 

_asm _emit 0x66; /* popad */ 

LPopa: 

_asm _emit 0x61; 

} 

/* End of File */ 
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Windows/POS 

□ DEVELOPER'S JOURNAL 

New Products 

Industry-Related News & Announcements 


Flipper Enhances FoxPro for Windows Graphics 


ProWorks is now shipping Ripper for FoxPro for Win¬ 
dows, a graphics library that simplifies adding charts and 
drawings to FoxPro for Windows programs. Flipper for 
FoxPro is available as an FLL (FoxPro DLL), so its func¬ 
tions can be incorporated directly into a FoxPro ex¬ 
ecutable program or used directly from the command 
window, giving the user of the FoxPro application every¬ 
thing required to create charts. 

Flipper for FoxPro can display data in two or three di¬ 
mensions, with unlimited graphs per page. Users can 
choose between 3D bar, line , and area charts, and can 

Consensys Ports UNIX SVR4 Tools to NT 

UNITE! is a direct port of over 100 UNIX System V Re¬ 
lease 4 commands to Windows NT, with versions avail¬ 
able for Intel, DEC Alpha, and MIPS processors. 

Commands in the UNITE! package include yacc, lex, 
make, and two popular UNIX command shells: the Korn 
shell and the Berkeley C shell. You can run UNIX com¬ 
mands from the NT shell, and run NT commands from 
either of the UNIX shells. UNITE! provides a GUI interface 
to manage multiple UNIX shells, and a dialog box inter¬ 


rotate 3D charts to any angle or elevation. X and Y axes 
can be reversed to produce horizontal 2D charts. The 
product includes automatic axis scaling, allows multiple 
graph types on one screen, and has provisions for two in¬ 
dependent Y axes, it also provides low-level drawing 
functions, including the ability to draw lines, boxes, arcs, 
circles, and polygons; you can also fill closed figures with 
solids or patterns. 

Flipper for FoxPro costs $349 and is royalty-free. For 
more information, contact ProWorks, P.O. Box 1635, Her- 
miston, OR 97838, (503) 567 -1459;fax (503) 567-8820. 


face for every UNIX command. Complete online UNIX 
manual pages are available as a Windows help file. 

UNITE! for Intel-based Windows NT systems costs 
$395 for a base system, $495 for the development tools, 
or $695 for both. Alpha and MIPS prices are $100 higher. 
For more information, contact Consensys Corp., 1301 Pat 
Booker Rd., Universal City, TX 78148, (800)388-1896; 
fax (905) 940-2903. 


Dependency Generator Adds C++ Support 


Sector Seven has released MakeMaster v2.60, the lat¬ 
est version of their makefile dependency generator for 
DOS. MakeMaster reads C source code and any header 
files to determine which files depend on which other files, 
then uses that analysis to generate a complete, correct set 
of makefile dependencies. The new version now supports 
C++ source code, and new features include an optimized 
file search algorithm, flat dependency lists, relative direc¬ 


tory references, and custom compiler command lines. 
MakeMaster supports projects that span multiple disks and 
directories, cross-compilers and linkers, libraries and DLLs. 

MakeMaster v2.60 costs $49.95. The product runs un¬ 
der DOS 3.3 or newer, and supports ANSI C and C++, Bor¬ 
land's make.exe, and Microsoft's nmake.exe. For more 
information, contact Sector Seven, P.O. Box 11391, Burke, 
VA 22009, (703) 866-9477. 


nu/TPU v4.0 Sports Improved Programmability 


a/Soft Development is now shipping nu/TPU v4.0, 
the latest version of its customizable text editor, now 
available for UNIX, DOS, Windows NT, and OS/2. 
nu/TPU's interface has been rewritten to provide faster 
performance and easier-to-create extensions. The source 
code to implement the new 'si' (simple interface) is 
shipped with the editor, giving users more control over 
the interface itself. 

The new version now provides unlimited 'undo', let¬ 
ting users back out lengthy editing changes. nu/TPU's 
windowed environments are now completely user-defin¬ 
able; the status line buttons, menu bar, pull-down and 
popup menus, color, fonts, and scroll bars can all be cus¬ 


tomized from within the editor. nu/TPU's memory man¬ 
agement now lets you edit large files without requiring 
contiguous memory allocation. The new version pro¬ 
vides multiple scroll bars for each window, making cur¬ 
sor movement quicker and easier to toggle. Buffer 
names are now case-sensitive. This version also supports 
more than 50 additional windowed built-in functions 
(useful, for example, in creating custom popup widgets), 
along with a number of non-windowed built-in functions. 

nu/TPU v4.0 costs $199 for DOS and $499 for UNIX 
systems. For more information, contact a/Soft, One Execu¬ 
tive Park Drive, Bedford, NH 03110, (603) 666-6699; fax 
(603) 666-6460. 
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ImageStream-VB Provides Image Display/Manipulation 


ImageStream-VB is a new VBX custom control that 
provides image file conversion and image management 
for Visual Basic and Visual C++ applications. 
ImageStream-VB handles both vector and bitmapped im¬ 
ages, as well as hybrid formats that contain both vector 
and raster components. The VBX is also designed to be 
used as a bound control, for use with Microsoft Access; 
images can be stored directly in database fields or as ref¬ 
erences to image files that are displayed when called. Be¬ 
sides loading and displaying multiple graphics file 


formats, ImageStream-VB can process images by manipu¬ 
lating size, color, brightness, contrast, gamma, and the 
screen palette. 

ImageStream-VB costs $295; you must pay royalty 
fees for using the product in any externally distributed 
application of more than 100 copies. For more informa¬ 
tion, contact Visual Tools, 15721 College Blvd., Lenexa, 

KS 66219, (800) 884-8665 or (913) 599-6500; fax (913) 
599-6597. 


MediaKnife/VBX Brings Multimedia to Visual Basic 


Media Architects is now shipping MediaKnife/VBX 
vf .0, a custom control that makes it easier for program¬ 
mers to add multimedia capabilities to their Visual Basic 
programs. The package provides media windows for 
backgrounds with transition and hotspot management, 
multiple sprites that can be flown across one or more 
windows with collision detection, and an authoring utility 
that lets you modify, assemble, and test backgrounds, 


transitions, hotspots, and sprites. You can place media 
windows in Visual Basic forms and overlay them with 
controls (including third-party custom controls). 

MediaKnife/VBX vl .0 costs $299. For more informa¬ 
tion, contact Media Architects, Inc, 1075 NW. Murray Rd. 
#230, Portland, OR 97229-5501, (503) 297-5010;fax 
(503) 297-6744. 


ForeFront Introduces WinHelp Authoring 

ForeHelp is a new help authoring tool for Windows. 
ForeHelp directly supports ail Windows 3.1 help features, 
including text and graphic hotspots, macros (including 
support for multimedia), browse sequences, and window 
classes, without requiring supporting applications. Fore¬ 
Help includes a WYSIWYG word processor and its own 
segmented hypergraphics editor for placing hotspots on 
pictures. You can import existing help projects, graphics, 
text, and RTF files directly into ForeHelp. 

ForeHelp also offers three tools to help you plan, 
view, and manage your help project. The Navigator 


Tool 

graphically displays connection and browse relationships 
among topics. The Grapher shows your project in hierar¬ 
chical outline form. The Reporter generates visual and 
printed reports on selectable topics and their properties. 
The product includes a test mode that lets you view and 
test your uncompiled project at any time. During the 
build process, you can jump directly to an error location. 

ForeHelp costs $199 if purchased by the end of April 
and $395 thereafter. For more information, contact Fore- 
Front, Inc, 5171 Eldorado Springs Drive, Boulder, CO 
80303, (303) 499-9181; fax (303) 494-5446. 


PractiSys Updates VB-to-VC Form Conversion Tool 


STORC GOLD is a Windows programming tool that 
converts Visual Basic . fra files into C++ projects, reusing 
both form design and VBX custom controls. Using STORC 
GOLD, you can prototype an interface in Visual Basic, 
then automatically convert the resulting . fra files into 
Visual C++ or straight SDK code to take advantage of 
the speed of a compiled language. 


STORC GOLD v2.0 costs $45.93. For more informa¬ 
tion, contact PractiSys, 4767 ViaBensa, Agoura, CA 
91301, (818) 706-8877. 


Kolibri Offers 3D Custom Controls 

The Kolibri Custom Control Library is a DLL that pro¬ 
vides 3D custom controls. Kolibri consists of twelve con¬ 
trol classes including animation, slider controls, swivel 
controls, formatted filtered input, list browse boxes for 
large databases, flexibutton controls, motion controls, 
checkbox controls, radio button controls, background 
controls, enhanced dialog boxes, and state controls. The 


controls integrate directly into Borland's Resource Work¬ 
shop and your program can manage them via a set of 
Kolibri window messages. 

Kolibri vl .2 costs $149, or $298 with source. For 
more information, contact European Software Connec¬ 
tion, P.O. Box 1982, Lawrence, KS 66044, (913) 832- 
2070; fax (913) 832-8787; CompuServe 71141,3624. 
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Codewright Update Adds Hierarchical Browsing 


Premia Corporation is now shipping Codewright v3.0 
for Windows and Windows NT. Codewright is a Win¬ 
dows programming editor that supports multiple key¬ 
board mappings (CUA, Brief, vi), color syntax highlighting 
and change marking, language support for C, C++, Pas¬ 
cal, xBase, and Paradox, hex-mode editing, text and file 
drag-and-drop, DLL and DDE support. 

The new version includes browser and tags support, 
giving you a hierarchical tree display to make it easier to 
find any particular class, variable, or function. This ver¬ 
sion also supports projects and workspaces, allowing 


Toolkit Provides Multimedia DLL 

MultiMedia Works Developer's Toolkit is a new multi- 
media engine for Windows applications that allows de¬ 
velopers or even power users to build multimedia 
applications or add multimedia to any new or existing 
Windows application. Any application or language that 
can call DLL functions can use the toolkit to access multi- 
media capabilities. An optional Lenel MIC Multimedia 
Drivers Kit expands the toolkit to cover a range of exter¬ 
nal video devices, such as laserdisc players, camcorders, 
and VCRs. 

The toolkit lets you play digital multimedia files in 
over 40 formats, execute control functions such as fast 
forward, stop, and rewind, control external video devices 
such as VCRs, camcorders, and laserdisc players, create 


you to group files into projects along with any special 
configuration settings. Other new features include side- 
by-side differencing, a ribbon editor, a menu editor, an in¬ 
dentation level separate from tabs, and multi-file search 
and replace. 

Codewright v3.0 for Windows and Windows NT costs 
$249; upgrades cost $69. For more information, contact 
Premia Corporation, 1075 NW Murray Boulevard, Suite 
#268, Portland, OR 97229, (503) 641 -6000;fax (503) 
641-6001. 


thumbnail images from multimedia files which can be 
embedded into target applications as OLE objects, size 
and place multimedia windows, combine and sequence 
multimedia files to create presentations, and automat¬ 
ically play any multimedia file with a drag-and-drop com¬ 
mand. 

The MultiMedia Works Developer's Toolkit costs 
$499. MediaDeveloper users can upgrade for $199 and 
MultiMedia Works users can upgrade for $399. The Le¬ 
nel MCI Multimedia Drivers Kit costs $99. For more infor¬ 
mation, contact Lenel Systems International, Inc, 290 
Wooddiff Office Park, Fairport, NY 14450-4212, (716) 
248-9720; fax (716) 248-9185. 


MicroTAP Cains ECA/VGA Support, More Log Capacity 


MicroTAP (formerly DataScope) is an asynchronous 
communications debugging, data capture, and analysis 
tool. This serial line monitor includes context-sensitive hy¬ 
pertext, user-alterable multitasking window displays, os- 
cilloscope-like signal event tracing, an integrated font 
map editor, and PostScript file export. The new version 
adds EGA/VGA font maps, a hypertext reader with direct 
links to program setup fields, and expanded log capacity 


to 64Mb. The product now includes a carrying case with 
storage space for the manual, cable, and connectors, 
along with a new tutorial. 

MicroTAP v3.0 costs $349 and includes cable, connec¬ 
tors, and manual. For more information, contact Paladin 
Software, Inc, 3945 Kenosha Avenue, San Diego, CA 
92117,(619) 490-0368; fax (619) 490-0177. 


Code Manager v2.1 Now Available for NT 

Cognitronix is now shipping Code Manager v2.1 for 
Windows NT. Code Manager is a ZIP, FAT, and NTFS file 
management and text search utility. It manages NTFS, 

FAT, and ZIP compressed files across multiple disks, 
based on the text contents or any other attribute, includ¬ 
ing date and size ranges. You can specify the files to 
manage by multiple true wildcards and exclusions. 

Search locations can be multiple complete paths or wild¬ 


card directory specifications. The package includes Code 
Editor, an editor that can open selected files and scroll to 
and highlight text found during a Code Manager search. 

Code Manager v2.1 for Windows NT costs $99. For 
more information, contact Cognitronix, 12322 Poway 
Road, Suite 120, Poway, CA 92064, (800) 217-0932 or 
(619) 549-8955. 


BASIC Script Language Gets OLE, NT Support 


Softbridge, Inc. has released Softbridge BASIC Lan¬ 
guage (SBL) v3.0. SBL is an implementation of BASIC (a 
syntax compatible with Visual Basic) designed to be inte¬ 
grated with your Windows or OS/2 application. The new 
version adds support for Windows NT and the OLE v2.0 
automation facility. 


Softbridge BASIC Language (SBL) v3.0 cost depends 
on your royalty arrangements with Softbridge; unlimited 
distribution licensing begins at $175,000. For more infor¬ 
mation, contact Softbridge, Inc, 125 CambridgePark 
Drive, Cambridge, MA 02140, (617) 576-2257; fax (617) 
864-7747. 
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Animation Utility Now Supports Device Independent Playback 


The MOVIE Animation Utility for Windows is a Win¬ 
dows 3.1 utility that creates animations by capturing 
screen images and playing them back to produce mo¬ 
tion. When playing back animations, the utility offers 
play, record, stop, pause, and speed control functions, as 
well as loop (for continuous play), hold (to pause be¬ 
tween loops), and an on-screen 'remote control' that con¬ 
tains frame seeking ability. 

The new version of MOVIE features a device-inde¬ 
pendent file format that lets you create movies on one 
screen and play them back on any other Windows 

screen device. The new file format also supports color 
palettes of 256 or more colors, and color palettes can be 
changed on a frame-by-frame basis. The package now in¬ 
cludes a royalty-free MOVIE player that lets you distrib¬ 
ute animations you create with MOVIE. You can use 

MOVIE to create animations that are embedded in Win¬ 
dows help files as well. 

MOVIE v4.0 costs $95. For more information, contact 

Lantern Corporation, 63 Ridgemoor Drive, Clayton, MO 

63105; (314) 725-6125. 


Get Win32s Data Acquisition Support with DriverLINX v2.0 


Scientific Software Tools, Inc. (SST) is shipping Driver¬ 
LINX v2.0, a series of multitasking, multiuser data-acquisi- 
tion drivers for Windows 3.x. DriverLINX provides a 
standardized, multivendor API to over 100 services for 
creating foreground and background tasks to perform 
analog I/O, digital I/O, time and frequency measure¬ 
ment, event counting, pulse output, and period measure¬ 
ments. This version adds support for 32-bit applications 
running under Windows 3.x, by supporting both WAT- 
COM's proprietary extensions for creating 32-bit Win¬ 
dows applications and Win32s, Microsoft's subset of 

Win32 for Windows 3.1. 

DriverLINX v2.0 costs $395; upgrades cost $49. This 
version supports the following data acquisition boards: 

Keithley Metrabyte DAS 16/1600/1400/1200 models 
and DAS 8 models, Advantech PCL-718/818 models. 

Computer Boards CIO-DAS 16 and CIO-DAS 8 models. 

Analogic LS/MS/HS DAS Series, ADAC's Optimum Conver¬ 
sion Series, and Data Translation 2801 Series. For more 
information, contact Scientific Software Tools, Inc, 19 

East Central Avenue, Paoli, PA 19301, (215)889-1354; 
fax (215) 889-1556. 


Kofax Updates Document Imaging Toolkit 


Kofax Image Products has released KIPP Advanced 
Developers Toolkit vl .5. The toolkit uses storage filters 
that handle image conversion on scanned documents, 
and the new version features storage filters for saving 
scanned images in a variety of file formats, including 

TIFF, PCX, CALS, BMP, EMS, and IMG. The new version 
also offers revised and rewritten documentation. The 
toolkit is designed for developers and integrators who 

need complete, low-level control over document imaging 
applications. 

The KIPP Advanced Developers Toolkit vl .5 costs 
$4,995 and is available for DOS, Windows, Windows NT, 

OS/2, UNIX, and AIX. For more information, contact Ko¬ 
fax Image Products, 3 Jenner Street, Irvine, CA92718, 

(714) 727-1733;fax (714) 727-3144. 


Develop Z80 Code under Windows with UEM-Z80 


Softaid has released an in-circuit emulator (ICE) for 
the Z80 processor. The UEM-Z80 is a Z80 development 
environment that runs under Windows and provides a 
Windows-hosted source-level debugger for code written 
in C and assembly language. The environment also of¬ 
fers built-in performance analysis. The UEM-Z80 supports 
up to 131,072 hardware breakpoints; you can set break¬ 
points on data values and create complex breakpoints of 
up to five levels of conditions. 

The package supports real-time tracing useful for de¬ 
bugging interrupt and DMA-based code, including a 4Kb 

trace buffer capable of generating views of the data as 
raw machine instructions, C source, or mixed C and disas¬ 
sembled code. Triggers qualify trace data collection, limit¬ 
ing acquisition to events of interest, all in real time. The 

UEM-Z80 also comes with a performance analyzer that 
monitors the time spent in up to 255 routines simultane¬ 
ously, with an accuracy of better than 100 nanoseconds. 

UEM-Z80 costs $5500. For more information, contact 

Softaid, 8300 Guilford Road Columbia, MD 21046, (410) 

290-7760 or (800) 433-8812; fax (410)381 -3253. 
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Edited by 
Leor Zolman 


Please send us your best 
cricks and hacks — those 
clever pieces of code to 
make things work the 
way they should! You’ll 
receive at least $50 for 
each tip that we print 
Send your submissions to.- 
Tech Tips 
Leor Zolman 
74 Marblehead Street 
North Reading, MA 01864 
leor@bdsoft.com. 


A Library Maintainer, Squeezing 
Some Water from the DOS Rock, 
and More Moving Windows 


Automating Object Library Development 


Tom Nelson 
Lansing Ml 48917 


Efficient updating and rebuilding of object libraries often requires capabilities 
beyond those commonly available to programmers. The most direct way is 
simply to maintain a MAKE description file for each library, but this quickly be¬ 
comes awkward when the library grows to an appreciable size. Other problems 
also become evident, such as the inability of MAKE to invoke the library man¬ 
ager in batch style (unless you explicitly list all object files) and the need to 
maintain intermediate object files on disk in order to circumvent a complete 
rebuilding of the library each time. 

Other possible solutions involve automating this approach. With variations, 
the general procedure looks something like this: 

1. use a utility that finds the source files to be updated and then writes a 
description file for MAKE, 

2. run MAKE to produce object files, 

3. invoke another utility that collects the object files and writes a response file, 
and 

4. run the library manager. 



Leor Zolman wrote BDS C, the first C compiler targeted exclusively for personal com¬ 
puters. Leor is currently an instructor on UNIX topics for Boston University's Corporate 
Education Center, a regular contributor to Sys Admin magazine and "Tech Tips" editor 
for Windows/DOS Developer's Journal. His first book. Illustrated C, was published 
by R8D Publications, Inc. in 1992. He may be contacted at 74 Marblehead St, North 
Reading, MA 01864, or on Usenet/Internet as: leor@bdsoft.com. 



















A batch file coordinates the entire procedure and, upon 
termination, deletes all the object files. 

To extend this approach, I wrote the MAKELIB Library 
Maintenance Utility, which puts all these capabilities and 
more into one unrumpled, streamlined package. Except 
for some specialized cases, it completely eliminates the 
need for a MAKE description file. MAKELIB invokes your com¬ 
piler or assembler to process the source file(s) specified on 
the command line, if you have modified them since the 
library was last rebuilt. It then builds an auto-response file 
from the resulting object files and passes it to the library 
manager, instructing the manager to add or update exist¬ 
ing modules. After the library is rebuilt, MAKELIB can either 
automatically erase intermediate .obj files, or leave them 
alone, as you prefer. 

You can use MAKELIB to maintain libraries coded in as¬ 
sembly language, a high-level language that supports ob¬ 
ject libraries, or a combination of both. MAKELIB can option¬ 
ally redirect assembly and/or compilation errors to a disk 
file for later review. Like MAKE, MAKELIB uses time-related de¬ 
pendency checking to determine if the source files you 
specify should be processed, unless you override this de¬ 
fault behavior. 


Listing 1 Sample MAKELIB build configuration file 


#—. 

# 

t Example .BLD file. Create at least one of these for each 

# library on the same directory as the library source files. 

# Run MAKELIB from within the same directory and use a build 

# file with a .BLD extension (default.) Or, use the -n command 

# line switch to use a build configuration file with another 

# extension or one located in another directory. Comments 

# may be used anywhere as shown. 

(/Text switches (case is not significant, whitespace is )_ 

COMPILERS:\BIN\TCC.EXE 
COMPEXTENSION=C 
ASSEMBLERS:\BIN\TASM.EXE 
ASMEXTENSION=ASM 
LIBMANAGERS: \B1N\TLIB.EXE 
TARGETLIBRARY=EXAMP.LIB 
OBJECTPATH=C:\PRJ\MISC 
ERRORFILE=EXAMP.ERR 
LIBLISTFILE=EXAMP.LST 
A$MCMDLINE=/mx /w2 $(S0URCE) 

COMPCMDLINE=-c -n$(OBJECTPATH) -N {(SOURCE) 

LIBCMDLINE=$(TARGETLIBRARY) /E @$(SOURCE),$(LIBLISTFILE), 
RESPCMDLINE=-+$(OBJECTPATH)$(SOURCE) & 

(/numeric switch . 

0B0LIMIT=75 

# Boolean switches. All of these are optional and may also 

# be specified on the command line instead, if desired . 

BATCHMODE # »» /B 

KEEPOBJS # == /K 

DELETEBAK # == /D 

FORCEBUILD # == /F 

LISTOPTIONS # == /L 

# . End of file . 


The MAKELIB command line looks like this: 

MAKELIB [options] [path]sourcefile [[pathjsourcefile] ... 

You can specify any number of source files, up to the 
limit of command-line length (127 bytes). You can also 
limit the scope of the rebuilding to just one file or to any 
number of files using wild cards. MAKELIB' s command-line 
option switches are introduced with either a or 7' 
switch prefix and are specified as follows (either upper- or 
lower-case): 

■b - Runs assembler or compiler in batch mode. When 
you specify source files using wild cards, MAKELIB will pass 
them on as a group instead of invoking the assembler or 
compiler separately for each file. Remember that some 
compilers and assemblers can't be run like this. This op¬ 
tion can save time, but note that, like the -f option below, 
it also disables MAKELIBs dependency checking. 

-k - Keeps all intermediate .obj files produced if you 
need these files for some other purpose. Remember that 
they will be passed to the library manager during MAKELIBs 
next run unless you delete them. 

■d - Deletes library .bakup file after rebuilding the li¬ 
brary. 

-/ - Forces processing of source files by disabling MAKE■ 
LIB s default dependency checking. Compilation/assembly 
thus proceeds regardless of the age of source files relative 
to the library. 

-/ - Lists all options found on the command line and in 
the .bid configuration file to standard output or to the er¬ 
ror file, if you specify one. Use this option if you want a 
record of exactly how MAKELIB was configured in a particu¬ 
lar situation. 

-n[path]file - Directs MAKELIB to look for an alternate 
build file that may have any extension. By default, MAKELIB 
searches for a file with the extension .bid on the current 
directory, and the name of this file need not appear on 
the command line. 

The build configuration file is where you configure 
MAKELIB s run-time environment, as well as specify com¬ 
mand-line options that you don't want to type in each 
time. If you keep all source files for each library in one 
subdirectory, you should create a .bid file for the library in 
the same subdirectory as your source files. Invoke MAKELIB 
from within this subdirectory and it will find the build file 
automatically. You can maintain additional build file(s) for 
each library, if needed. Simply create a build file with 
some other extension and indicate the file on the com¬ 
mand line with the *-n' switch. A summary of build file 
options follows (refer to the example, Listing 1): 

COMPILER - Full path and name of compiler, with exten¬ 
sion. MAKELIB does not search the DOS PATFL Required 
if you have source to be compiled. 

COMPEXTENSION - Extension of source files to be com¬ 
piled. Default extension is .c. 

ASSEMBLER - Full path and name of assembler, with ex¬ 
tension. Required if you have source to be assembled. 
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ASMEXTENSION - Extension of source files to be assem¬ 
bled. Default extension is . asm. 

LIBMANAGER - Full path and name of library manager, 
with extension. Required. 

TARGETUBRARY - Full path and name of library to be cre¬ 
ated or modified, with extension. Required. 

OBJECTPATH - Location where the compiler or assembler 
will deposit its .obj files and where the library manager 
will look for them. Default is the current directory. 
OBJLIMIT - Maximum number of .obj modules to be 
added to library during each run of the library man¬ 
ager. Default is 100. 

ERRORFILE - File to which standard output is redirected. 
This file will catch standard console output from the 
compiler or assembler for later review. 

ASMCMDLINE - Command line for the assembler. Re¬ 
quired. 

COMPCMDLINE - Command line for the compiler. Re¬ 
quired. 

LIBCMDL1NE - Command line for the library manager. Re¬ 
quired. 

RESPCMDLINE - Format for response file lines. Required. 
LIBLISTFILE - Library listing file. Default is no file. 
BATCHMODE - Same as '-b' command-line option. 
KEEPOBJS - Same as '-k' command-line option. 

DELETEBAK - Same as '-d' command-line option. 
FORCEBUILD - Same as ‘-f command-line option. 
LISTOPTIONS - Same as '-I' command-line option. 

Command lines specified in the build configuration file 
use replaceable arguments indicated by $(...), exactly as 
for MAKE. The only difference here is that what you put 
inside the parentheses must be one of the build file op¬ 
tions listed above. You can't define your own variables. 
When you need to specify a source file in a command 
line, use the keyword SOURCE, as in S(SOURCE). MAKELIB will 
replace it with an actual file name at runtime. See the 
example in Listing 1. 

MAKELIB does not take control file dependencies (such as 
//include files) into account. Doing so might defeat the 
whole idea of dispensing with the MAKE file. If any readers 
have practical ideas concerning this, I would appreciate 
learning about them. Assuming you have library modules 
that depend on changes to //include files, run MAKELIB to 
reprocess the affected source files, since you probably 
have a good idea of which files are involved. Using file¬ 
name prefixes may help in this regard. For example, if you 
make changes to file window, h, you should reprocess all 
source files beginning with 'wn' (e.g., MAKELIBwn*. c -f). in 
practice, I have found that shortcomings of this nature are 
more than offset by MAKELIB' s ease of use. If all else fails, 
you can always rebuild the entire library (e.g., MAKELIB 
*.asm -b). This seems to take very little time. 


Command-Line Programmers' Utilities 


Laura Michaels 
INTERCOMP 
Box 6514 
Delray Beach, FL 33484 

Three functions that I find useful when writing pro¬ 
grams aren't always readily available at a job site. These 
useful functions are: 

• Comparing all files in two different directories 

• Scanning a group of files for a specific string 

• Locating a specific file among several directories on a 
disk 

While several utilities perform these functions, not all 
companies allow their employees to have unofficial soft¬ 
ware on their drives at work. However, if you have DOS 5 
or later, you can reproduce these utilities yourself using 
simple DOS commands. 

Comparing Files 

To compare all files in two different directories, you can 
use the fc command. The following example shows how 
to compare all files in the current directory with those in 
the “otherdir" directory: 

fc /a /lbl /I /w /c *.* \otherdir\*.* | more 

The /a option gives an abbreviated output and the /lbl 
option stops comparisons after the first mismatch. These 
options keep the screen from filling up with a long display 
of file differences. The // option forces an ASCII compari¬ 
son. Without this option, if two files such as executables 
are compared, the screen easily becomes filled with a list¬ 
ing of byte differences and locations. The /w option elimi¬ 
nates white space in the comparison, so that extra lines 
won't throw the comparisons off. The /c option ignores 
the case of letters in the files compared. Any file and di¬ 
redory path that can be used with the dir fundion can be 
supplied to the fc command. 

String Searches 

A utility like grep is great for finding a string in a group 
of files, but if there's no implementation of grep handy, 
you can use the find command in DOS. find only searches 
the files you specify on the command line. To make it 
handle more general file names and paths, you can use 
something like the following: 

command /c for %f in (*.*) 

do find /i /n ''searchstring" %f | more 



Due to its length, the code for this tip is available only on 
the code disk - see Table of Contents for Online Source 
availability. -Iz 


Substitute for '‘searchstring" any value you want to locate. 
The * * can be replaced by other file and diredory paths, 
such as those used with dir. The command /c is needed 
when you want to pipe the output to the more filter. The // 
option ignores the case of letters in the file being 
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searched. The /n option shows line numbers of matches 
as well as lines. To use this command in a batch file, You 
must place two percent signs before the files variable. The 
result would look something like the following, finder.bat: 

command /c for %%f in (%2) do find /i /n "%1" %%f \ more 

The batch file could then be used by giving the command, 
search string, and directory, such as: 

finder word * *.* 

Locating Files 

You can use chkdsk to search for a file in several 
directories using only DOS commands. An example would 
be as follows: 

chkdsk /v I find "searchstring" I more 

Although this works with older versions of DOS, there are 
some disadvantages. One such disadvantage is that the 
search string has to match exactly and needs to be in 
upper case. (For DOS 5 and later, using find with the new 
// option takes care of the case problem.) The other 
disadvantage is that if chkdsk finds a problem with your 
disk or if you have version 6.2 of DOS, it will wait to 
receive keyboard input. When the output is piped through 
more, you won't see the request for keyboard input, so you 
could end up waiting a very long time. While there are 
ways around this (using a batch file and batch com¬ 
mands), there is a new and easier method. The latest 
options for the dir command allow for the following: 


dir /s /p /m /on \file.doc 
dir /s /p /m /on file.doc 

The file.doc can be replaced by any valid file name. The 
dir command also allows use of wildcards such as ? and 
* 

The I before file.doc in the first example says to start 
searching in the root directory and go down the directory 
tree from there, but any starting directory can be desig¬ 
nated. Without a leading pathname, as in the second 
form, the search begins in the current directory and in¬ 
cludes only subdirectories from the current directory 
down. 

The /s option tells dir to search lower subdirectories. 
The /p option pauses the output each time the screen fills 
up. The //n option eliminates the statistical summaries 
normally displayed at the end of a dir command. The /on 
option sorts file names alphabetically. Other sort options 
available with the dir command are extension, size or 
date, and time. 

So, next time you're using a computer and don't have 
a lot of utilities available, or you're switching among 
several computers and don't have time to learn about all 
the new utilities on each machine, try out some of these 
tips. You can also expand on some of these ideas to 
create other new and useful utilities, such as a list of all 
directories using dir, an easy way to strip documentation 
from code using find, etc. 

I've been using DOS for many years, and some time ago 
(perhaps during the reign of version 3.3) 1 finally "accepted" the 
fact that the basic command repertoire was and would always 
be sadly deficient in functionality. Perhaps this was Microsoft's 
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Enables Windows developers to generate compressed 
self-loading executables (.EXE) and Dynamic Link Librar¬ 
ies (.DLL), thus reducing file sizes an additional 50%. 

Benefits include: 

• Loads applications faster 

• Saves you $’s - fewer 
diskettes to ship 

• Speeds up installation tirr 

• Complicates reverse 
engineering 

• Reduces your customers' 
disk requirements 

• Only requires relinking 
Other reasons to use OPTUNK: 

• Fastest Windows linking • Builds the smallest programs 

• Unrivalled capacity • No limits on debug information 

• Eliminates RC. IMPLIB. IMPDEF 
TO ORDER CONTACT: 

SLR Systems, Inc. 

1622 N. Main Street, Butler, PA 16001 USA 
Phone: (412) 282 0864; Fax: (412) 282-7965 
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way of throwing a bone to third-party developers ... in any 
case, my lack of expectations in this department perhaps pre¬ 
vented me from looking closely at the minor enhancements 
that have found their way into more recent updates of the oper¬ 
ating system. To me, the most striking revelation among Laura 
Michaels' batch scripts was that there really is a way, under 
DOS, to search for a specific file on a specific sub-branch of the 
directory tree, i.e., the current directory. This is equivalent to the 
standard UNIX statement: 

find . -name "pattern" -print 

Since I've never taken the time to write a tree-perusal routine 
in C which I might have been able to plug in to a basic find of 
my own creation, the only tool I've ever used for this purpose is 
an old Public Domain utility named FINDIT.COM that, while fast 
as blazes, insists on searching the entire current drive on every 
invocation. Even working at roughly half the speed of FIN- 


DIT.COM, the dir command method shown above can find my 
file a lot faster than FINDIT. COM can, so long as I know the right 
directory node from which to initiate the search! I guess there's 
some life left in vanilla DOS yet... -Iz 

Moving Windows, Revisited 


Stephen B. Kinsch 
Denver, CO 


In the January 1994 Tech Tips column there was a tip 
on moving windows without captions. I've found a better 
way to do the same thing that does not rely upon un¬ 
documented messages. A little bit of knowledge about the 
messages Windows sends when the mouse moves across 
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We Understand The 
Programmer's Mind 


When the country's top firms look for the 
best developers available, they turn to 
Bateman. Why? Because we specialize in 
Microsoft Windows, NT, OS/2 and Macin¬ 
tosh recruiting nationwide. So if it's time for 
a career move, give us a call. We under¬ 
stand your skills, and the marketplace for 
them... we understand you. 

B Bateman Inc. 

5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax: 310-641-2900 
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Multiple COM: Ports With Windows! 

* WINDOWS 3.x AND NT COMPATIBLE 

* 1,2,4 OR & PORT RS-232 BOARDS 

* WINDOWS UTILITY SOFTWARE 
PROVIDED 

* XT AND AT INTERRUPT JUMPERS 

* DRIVER AVAILABLE FOR 9 COM: PORTS 
WITH WINDOWS 3.1 

* MADE IN USA 

* EXCELLENT TECHNICAL SUPPORT 

SEALEVEL SYSTEMS, INC. 
PO BOX 830 
LIBERTY, SC 29667 
503-843-4343 
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The Time 
Has Came... 

...to send for the latest copy of 
the free Consumer Information 
Catalog. It lists more than 200 
free or low-cost government 
publications. Send your name 
and address to: 

Consumer Information Center 
Department TH 
Pueblo, Colorado 81009 

U.S. General Services Administration 
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Diskette I/O 

Code Libraries 
Device Drivers 

VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

WlirJ AY PO Box5700 
L/J Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 


Tools for Novell's Btrieve® 


Bsupport III BsupportH 

Bed it 3.0 - Btrieve file viewer/editor. 
Banalyze 2.0 - Btrieve app. debugger. 

Brun 2.2 - BUTIL replacement plus source. 
Bcrcatc 2.0 - file creation ulilily. 

Bclieck 2.0 • Btrieve file analyzer. 

Xsupport 1.0 - build data dictionary 
(.DDF) for Access, OV, 
Crystal Rpts. 

Xport 2.0 - export/import CDF, SDF, 
dBASE. 

Call for information on additional 
products and FREE demo! 

Information Architects, Inc. pj,. (goo) 359-2721 
3130 Pine Tree Road (517> 887-8000 

Lansing, MI 48911 Fax: (517) 887-2366 
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SpyWorks-VB 

For Visual Basic™ - Windows 

SpyWorks-VB allows you to do virtually 
anything in Visual Basic that is possible 
using other languages such as C. It 
includes controls that easily subclass 
VB forms and controls, detect keyboard 
events, and support callback functions. 
SpyWorks includes debugging tools to 
view message and event history, detect 
API parameter errors, Browse Windows 
memory and resources, and retrieve 
information about any window, form or 
control in the system. 

SpyWorks-VB is only $129 + $5 s&h ($15 
outside U.S & Canada). Visa/MC orders 
include phone and exp. date. CA residents 
add 8.25% sales tax. Dual media - Requires 
VB2.0 

Desaw are 

5 Town & Country Village #790 

San Jose, CA 951 28 

(408) 377-4770 fax:(408) 371-3530 
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Career Marketing Associates 

7100 East Belleview Avenue. Suite 102 
Englewood. CO 80111 


Today, 1993 

Dear WINDOWS DEVELOPER: 

Do you know where the best 
Windows development jobs are? I spend 
my time looking for strong 
opportunities for Windows developers 
and software engineers. I might be 
looking for someone with your 
qualifications right now. And there you 
sit in the corner reading a magazine I 
Pay attention, this is your future we 
are talking about. Currently I have 
multiple jobs requiring Windows 
experience, C++, or GUI. If you are 
thinking about a career change, 
shouldn’t you be working with a 
specialist? All fees are paid by the 
company. Write, call, fax, or 
communicate by smoke signals, I'm, 
waiting to hear from you. / 


Sincerely, 



Gary Patton 
303-779-8890 
FAX 303-779-8139 


; \ 

Windows 
Developer Jobs 

Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 

Mac, CASE, Video, Realtime. 

Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 

1-800-231-5920 
Scientific Placement, Inc. 

SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SPI-8, Box 71, San Ramon, CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 854-9444 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 
VCompuserve: 71250,3001; Genie: D.SMALL6 J 
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IPX Toolkit 


This custom control allows a Visual 

Basic developer to write distributed, 
client/server applications. The control 
abstracts the networking layer of a 
workstation and 
allows applications 
to communicate on 
top of various 

transports including 
IPX and NetBIOS. 

A separate Windows dynamic-link library 
(DLL) is available for each transport and 
is demand-loaded based on a 

workstation's networking configuration. 
$295 Per Transport. 

Intelec Systems 

10201 W. Markham, Ste. 101 
Little Rock, Arkansas 72205 
Tel (501) 221-3600 • Fax (501) 221-7412 


□ Request 238 on Reader Service Card □ 



Opt-Tech Sort/Merge 


^ New - Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

(702) 588-3737 J 
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CDROMs for Work and Play! 


Giga Games CDROM $39.95* 

Over 2700 Games for Microsoft Windows and 
MSDOS. 250 Megs of games plus 150 Megs of 
source. Lots of educational games. July 1993. 
CICA MS Windows CDROM $29.95* 
2518 files of MS Windows programs. Utilities, 
games, source code, programming tools, fonts, 
drivers, icons. April 1993. 

Simtel MSDOS CDROM $29.95* 

650 Megabytes, 9000+ files.Programming tools, 
utilities, editors, education, source 
code and more. May 1993. 

* Shareware programs 
require separate payment 
to authors if found useful. 

1-800-786-9907 orders@cdrom.com 
FAX 1-510-674-0821 
$5 S&H per order (USA Canada Mexico) 

$10 overseas 1-510-674-0783 AMEX/VISA/MC/COD 
**. All our disks are 
.** unconditionally guaranteed. 

Walnut Creek CDROM 

4041 Pike Lane, Suite D-699 
Concord, CA 94520 
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The Art of Visual Basic Programming ™ 

This amazing new book by J, D. Evans, Jr. unlocks 
the secrets of Windows and Visual Basic 
application design and programming. It explains 
Windows design from a unique and easy to 
understand perspective. Smart Objects, Hybrid 
Objects, Control Coupling, Events, Focus, Event 
Triggering, Visibility, Form and Module Code 
Placement, DLL Parameter Passing, Variable 
Scope, Strings, and Structures are described and 
explained. Enlightening allegories and annecdotes 
make this one of the most unusual and informative 
Windows books ever written. This book is the 
Rosetta stone for Windows and Visual Basic! 


Book: $29.95 Companion Disk: $9.95 
ETN Corporation 

RD4 Box 659 Montoursville, PA 17754-9433 
(717) 435-2202 (Sales) (717) 435-2802 (FAX) 
AMEX/MC/VISA/Check/MO/PO/COD 
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your application suggests that by processing the UH_NCHIT- 
TEST message, you can fool Windows on the placement of 
the mouse. For example, to move a captionless window 
you would do the following: 

case WMJCHITTEST: 

{ 

UINT uCur = DefWindowProcChWnd, uMsg, wParam, lParam); 
if (uCur == HTCLIENT) 

uCur = HTCAPTION; 
return uCur; 

} 


The call to DefUindowProcO retrieves the current hittest 
value. You can check to see if it is in the client area and, if 
so, change it to be the caption; else, just return the current 
hittest value so that things like sizing cursors show up as 
they should. This fools Windows into thinking it is in the 
caption area and causes it to perform the moving opera¬ 
tion when the left mouse button is depressed. 

This method should be no stranger to those who have 
developed floating toolbars with half-height captions. 
Since you have to draw the caption, you also have to tell 
Windows when to drag it. This method has also been 
mentioned in other articles, specifically in the MSJ vol. 7 
no. 6 article, "Dave's Top Ten List of Tricks, Hints, and Tech¬ 
niques for Programming in Windows," by Dave Edson. □ 
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BRIDG/r™ 


Your Windows & DOS - dBConnection 



Bridgit is a full featured database engine that provides 
easy to use functions for creating, reading, updating 
and indexing dBase-lll+ and Clipper files. 


With Bridgit you create your application only once...then 
convert it to Windows or DOS using either dBase-lll+ or 
Clipper files. 

Order the ultimate database engine for Visual Basic 
and Visual C++ for just $69.95. 


Unelko Corporation 

Tel:(602) 991-7272 • Fax:(602) 483-7674 
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Create High 
Performance 
Network 
Applications 
FAST! 

Now Shipping 
Version 2.03! 

60 Day Money 
Back Guarantee! 


lor Windows 3.x 


0 Shared DLL resources 
supports multiple applications 
and instances. 

0 Full post processing support 
& notification via messages 
(wait, no-wait, and polled). 

0 Complete NCB and attached 
data buffer functions simplify 
memory management. 

0 Complete documentation and 
on-line API help reference. 

0 Control panel utility allows 
dynamic DLL configuration. 

0 W1ND0WS.TXT compatibilty 
for DOS support. 

0 No royalties, full source with 
demos. Now only $129.00! 


SIGMA SOFTWARE RESEARCH 

702 Windridge Dr., Atlanta, GA 30350 

S TEL/FAX (404) 992-0536 

Also available at the Programmer's Connection! 
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FREE Report 


How to Eliminate 87% 
of C Programming Errors 
in less than 2 hours! 

This valuable report reveals secrets 
known by less than 5% of all profes¬ 
sional programmers. These little 
known but powerful techniques prev¬ 
ent almost 90% of all design and main¬ 
tenance errors with the guarantee that 
your compiled code will be virtually 
error free. Limited quantity available. 

Logic Technologies 

1 (619) 228-9653 , FAX 1 (619) 369-1185 
^56089 29 Palms Hwy. Ste 254-CJ, Yucca Valley, CA 9228^J 
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TCP/IP Tools 

GCP++ is your solution for TCP/IP 
development under Windows 

Dart Communications offers powerful 
programming tools for C/C++ and VB 
developers. 

• Rapid prototyping support 

• Windows Sockets 1.1 SDK 

• VBX, OLE 2, and DLL interfaces 

• VT-220, TCP, UDP, TFTP, TELNET tools 

• VT-220 for Workgroups site licenses 

Consulting/custom development services are available. 

JV JWP 6 Occum Ridge Road 

' UMKI Deansboro, NY 13328-1008 
COMMUmamOHS Tel/Fax 315.841.8106 
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Sound & Vision Edition 




A hypertext / hypermedia Help Database Development Kit 
with two royalty free help engines and a help compiler with a 
built in cross reference tool. The current version is 10.0. 


ONE source generates help for MANY target formats like: 
Windows, OS/2, Microsoft Multimedia Viewer, THELP, 
DESQview/X, QuickHelp, PopHelp, word processors, text 
documents with table of contents, glossary and index. 

Write Once Help Many ! 


Supports Topics, PopUps, Links, Keywords, text formats, 
navigational and structural facilities, target code insertion, 
multiple module files, automatic Pascal/C/C++ reference 
generation, exception handling, graphics, sound, groups, 
multiple file target databases, Application Launch, user 
defined link templates, auto exports creation, and more. 

Get a demo version of HLPDK from CompuServe, Internet, 
PsL and other popular catalogs and BBS's. 

Order your copy from I Soft D&M or PsL today ! 


$50 

+S&H 


HyperAct, Inc. 

P.O.Box 5517, Coralvilie, IA 52241 
Tel/Fax (319)351-8413 
CompuServe 76350,333 


□ Request 125 on Reader Service Card □ 


April 1994 






















































Export Your 
Software IMow 


Let us help you increase your export sales! 
Octagon develops foreign markets for 
small and medium size software publish¬ 
ers, including start-ups. 

• Quickly penetrate new markets 

• Conserve scarce internal resources 

• Find the best distributors and 
republishers for your product 

• All fees based on your success 


9 )' 


Octagon Trade 
Group, Inc. 

Suite 102, 3020 Pickett Rd., #759 
Durham, NC 27705 
Tel: 919-493-1651 Fax:919-493-1915 
E-Mail: octagon@mercury.interpath.net 
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Access Windows 
Master Environment! 


WinPath-vl.l provides previously 
unavailable path and environment 
variable management functions 
directly from within Windows. 
Visual Interface, command 
language, DDE and command line 
control. Affects all Windows tasks 
and DOS sessions. Simple path 
modification and editing. Extends 
path beyond the DOS 127 byte 
limit. WlnPath Is the logical 
extension of the DOS PATH and SET 
commands for Windows. 



★★ Anchor Software, Inc. 

P.O. Box 124 
Cheswick, PA 15024 


$ 30 +s&h 


Tel :(412)274-6504 Fax:(412)274-5010 


Sentry Spelling Checker Library 


Add a spelling checker to your 
DOS/Windows applications! 

■ 100,000-word dictionary 
13 kinds of user dictionaries 
■$299 US 


ThesDB Thesaurus Library 


Add a thesaurus to your 
DOSA/Vindows applications! 
1110,000 synonyms/20,000 key words 
I $299 US 


Both products feature: 

■ C/C++ API 

■ DOS obj libs & Windows DLL 

■ No royalties or runtime fees 
■ANSI C source code available 


1 


WirvfeH'r-ee Software Jnc. 

43 Rueter St. Nepean, Ont. Canada K2J 3Z9 

825-6271 CIS: 72060,3056 


& 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 

provide synchronous support for your 

product that is cost effective, compliant, 

full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 


Inc. 


SANGOMA Technologies 

Your communications Link 
Tel: (905) 474-1990; (800) 388-2475 
FAX: (905) 474-9223 


International 
Software Careers 

The International Computer Professional 
Association gives you up-to-the-moment information 
and world wide contacts you need to find an exciting 
overseas assignment. Every two weeks you'll receive 
a detailed listing from international recruiters for soft¬ 
ware related jobs located throughout the world. Jobs 
like micro programming/analysis, software engineer 
ing, system sales, LAN/WAN support, and others. 

As a member of the ICPA you become part of a 
dynamic international network of software profession¬ 
als and technical recruiters. People with years of expe¬ 
rience in the international software market who will 
show you how to find an assignment abroad. Call us to 
receive a membership package for this new global 
organization of software professionals. 

ICPA 

350 Townsend Street, Suite 301 
San Francisco, CA 94107 USA 

24 hour Tel: 1 (415) 695-7618 n-^r — 

24 hour Fax: 1 (415) 543-3022 Ii CC-JF ^F^ 


SDK PROGRAMMERS: 

Want to subclass SDK API's 
such as TEXTOUTf)? 


TrapFunc Library for Windows 

This programming library will give you the 
ability to subclass virtually any Windows 3.1 
SDK/DDK API or third-party DLL function 
export with your own user defined callback 
functions. Consider the power you would have 
if you could replace a Windows API such as 
TextOut() with your own callback function. 
(Library distribution is royalty-free.) $500 

CALL TODAY TO PLACE YOUR 
ORDER: (818) 807-2785 
FAX: (818) 345-8905 

"Download our program samples" 

BBS: (818) 343-8433 

EOT 
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Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


1. Create fantastic prompts 
and save time with VFEdit 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/I2x boards 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/F DLL™, our Tel I/F 
Dynamic Link Library 

3. Audio Tool Box™ 
converts to and from 


Multimedia Wave (16, 8 & 
MS ADPCM), linear 16 & 
unsigned 8, plus Dialogic 4 & 
8 at any sample rate* 

4. Scribe Transcription 
Utility for DOS plays digital 
audio files in the background 
without voice mail hardware! 

5. Add Text-to-Speech 
capability to your apps with 
Vox Fonts™, our "software 
only" text-to-speech library! 


Order Now! 1-800-234-VISI 


I Voice Information Svstcms: 24 N Mcrion Avc. Bryn Mawr. Pa 19010 

Tcl:215-747-5035/ BBS:310-392-6610/ Fax 1-800-234-FX1T 
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DICE IS LOOKING FOR.. 


...data processing, engineering and 
technical writing professionals to fill 
open positions nationwide. DICE is 
a FREE online job search service 
providing detailed information about 
current contract and full-time 
positions across the USA. It’s a 
confidential, easy to use, no cost 
way to search for a new job. 


DATA PROCESSING 
I NDEPENDENT 
CONSULTANT’S 
E XCHANGE 

ONLINE Number 
515 - 280-3423 


Contact DICE via 1200/14400 baud 
Modem, 8-N-1. 

A service of D&L Online, Inc. 
515-280-1144 


w 

< 

o 



WlnToAsm 

Disassembles MS-Windows EXEs, 
DRVs, DLLs, and VxDS, by 
segment, range, or export. 

Labels exported and imported 
functions, VxD services, 
control proc, API entry, etc. 

Generates segment, export, 
import, and header tables. 

Supports batch-mode tagging of 
functions and data items 

ResToRC 

Decompiles resources to a RC file. 

¥e»Tract 

Extracts VxDs from Win386. 

All for only $94.95! 
30-day Money-Back Guarantee 

Eclectic Software 

I 937 Jungfrau Court 
Milpitas.CA 95035 
(408) 262-3264 Voice/FAX 
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When protecting your software against piracy and 
unauthorized use, make sure that your protection 
system has all the following qualities: 


A GOOD HARDWARE KEY 

Hardware-based software protection systems are now the 
standard worldwide. However, not all keys are the 
same. A good key should have all the following 
features: 

| y/ Compatibility and transparency. The key 
I should work without any problem on your 
customers' computers. The user should be 
able to forget the key after connecting it. 

y/ Unbreakable electronics. A customized ASIC 
(Application Specific Integrated Circuit) component 
integrated into the key to prevent reverse engineering and make cracking 
the hardware virtually impossible. 

y/ A unique and inaccessible developer’s code burnt into the ASIC. This 



code should never be held in the key’s memory, where it can be read and 
altered. 

\/ A Read/Write Memory inside the key should be 
available. The memory should be writable in the 
field, on any PC, without any special programming 
equipment. 

y/ Very low power consumption, enabling the 
key to work even under the most adverse power 
conditions, on PCs and laptops, with or with¬ 
out a printer. 

POWERFUL SOFTWARE 

>/ A Linkable Protection Module with which calls can be made to 
the key from any point in the protected program. 

y/ An “Envelope” encryption program. Such programs enhance security 
while making it possible to protect a software application even without its 
source code. 

y/ Sophisticated antidebugging and encryption mechanisms. 




HASP*- The Professional Software 
Protection System ■ 


MacHASP - The Professional Software Protection System for the Macintosh 


HASP® OFFERS YOU 
ALL THESE FEATURES 
AND MORE: 

HASP was designed by a team of computer ex¬ 
perts, professional cryptologists, and electrical 
engineers. As a result, HASP keys are supported 
by what is probably the best software in the mar¬ 
ket, and the HASP system has worked on every 
computer it has been tried on. In addition to all 
the features mentioned above, HASP provides: 
y/ A Full Authorization System for protecting 
dozens of programs using only one key. 

y/ A Pattern Code Security System (PCS) which 
enables parallel processing of multiple calls by 
the Linkable Protection Module. 

y/ A Virus Detection option that can be in¬ 
corporated in the protected program to check 
whether it has been infected by a virus. 

^ Several HASP keys can be connected one 
behind the other, Small physical size ensures 
maximum convenience for your customers. 

NETHASP- THE ULTIMATE 
SOFTWARE PROTECTION 
FOR NETWORKS 

^ Only one NetHASP key is needed to run a 
protected program from any station in a network. 
NetHASP provides full support for protecting DOS 
and WINDOWS software under network 
environments, including Novell dedicated & 
non-dedicated servers, Lan Manager, Lantastic, 
Banyan, DLink, and NET-BIOS based LANs. 


LISTEN TO THE EXPERTS: 

In all the products we tested, except the HASP, 
we could see through the encrypting and 
questioning procedures... and crack them. 

CT Magazine (Germany) 
MemoHASP: ...of all the protection devices tested 
is without any doubt, the one which combines 
the best features. 

PCompatible (Spain) 

Trying to crack a program... that was protected 
utilizing all of HASP’S features - is like searching 
for the Holy Grail. 

Micro Systems (France) 

PC dongles... come with varying claims as to 
their transparency. The majority suffer from 
problems when a printer is connected... the 
DESkey and HASP-3 are not affected... 

Program Now (Britain) 
Of all keys tested, HASP is the most ambitious 
one... the quality of HASP manufacturing seems 

PC Compatible (France) 

An easy to use software protection system for 
the Macintosh, which ensures an effective 
defense against software piracy... 

Life is difficult for pirates... MacHASP is an 
optimal protection method, for the 
programmers... and for the users... 

Bit Magazine (Italy) 


OPERATING 

ENVIRONMENTS 

PC: DOS, WINDOWS, WINDOWS -NT, OS/2, 
SCO UNIX, SCO XENIX, INTERACTIVE UNIX, 
AIX, AUTOCAD, DOS EXTENDERS, LANS 
MAC (ADB port): Svstem 6.0.5 and up 

NEC (Serial Port): DOS, WINDOWS 

AND THE BOTTOM LINE: 

We offer some of the most competitive 
prices in the market. 

Since 1984, HASP has enabled thousands 
of software producers in more than 50 
countries, including several Fortune 500 
companies, to protect their software. 

Call now for your HASP evaluation package. 


ALADDIN 


The Professional's Choice 

North Aladdin Software Security Inc 

America The Empire State Building 

350 Fifth Avenue, Suite 7204 
New York, NY 10118, USA 
Tel: (800) 223 4277 
212-564 5678 
Fax: 212-5643377 

International Aladdin Knowledge Systems Ltd. 

Office 15 Beit Oved St., Tel Aviv, Israel 

P.O.Box 11141, Tel Aviv 61110 
Tel: 972-3-5375795 
Fax: 972-3-5375796 
AppleLink: ALADDIN.KNOW 
CompuServe: 100274,434 

France Aladdin France SA 

Tel: 33 1 40 85 98 85 
Fax: 33 1412190 56 




LISTED ACCESSORY 
6C6I 


■ Australia Conlah 3 8985685 ■ Belgium Akkermans 3 2338826 ■ Czech ATLAS 2 766085 ■ Chile Micrologica 2 222 1388 

■ Denmark SC Metric 42 804200 ■ Finland ID-Systems 0 870 3520 ■ Germany CSS 201 7498640 ■ Greece Unibrain 1 6856320 

■ Holland Akkermans 45 241444 ■ Italy Partner Data 2 26147380 ■ Japan Athena, 3 58 213284 ■ Korea Dae-A 2 848 4481 

■ New Zealand Training , 4 5666014 ■ Poland Systherm 6l 475065 ■ Portugal Futurmatica 1 4116269 ■ South Africa D Le Roux, 11 886 4704 

■ Spain PC Hardware, 3 4493193 ■ Switzerland Opag 6l 7112245 ■ Taiwan Teco 2-555 9676 ■ Turkey Mikrobeta 4-4677504 
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AVOID EMBARRASSMENT! 



“A customer found a bug in 
our software with a tool 
called BOUNDS-CHECKER . . . 

Why aren't we using 

BOUNDS-CHECKER?” 


I 


Use BOUNDS-CHECKER™ V2.0 For Windows , The Automatic Bug Finder! 



laments 


IDKHOIHainWndProc(h« 
DKHO!_stubaain (00011 


SELECTPALETTH paran 2 is invalid - GDI OBJECT: 0000 


Events 


♦ Calls | ♦ Returns |» Win Msgs] + Dig Msgs 1 + Outstr \ ♦ LogError | Find 


APIRET: 
APICALL 


L0CALL0CK returns: 3ADA 
CRKATBPALETTE (PTR:I01 ) 


CREATEPALETTE returns: 0000 


BCHKW 


Announcing BOUNDS-CHECKER V2.0 For 

Windows, the software developers "safety-net". 
Quickly and easily eliminate the hardest-to-find 
Windows errors that can take days - even weeks 
to find like: 


• API Parameter Errors 

• API Return Value Errors 

• Data and Heap Corruption 

• Resource Leakage Problems 

• Memory Leakage Problems 

• Processor Faults 


HOW IT WORKS - BOUNDS-CHECKER works by 
transparently setting hundreds of breakpoints within 
your program to monitor its behavior. When a bug 
is detected, BOUNDS-CHECKER immediately stops 
your program and pops up showing the problem. 

You can then inspect your program's source, vari¬ 
ables, stack and heap ... with BOUNDS-CHECKER's 
powerful display windows. 

EVENTLOGGING-BOUNDS-CHECKER nowlogs 
all Windows events. Many Windows bugs are diffi¬ 
cult to find because of the event driven, multi-tasking, mes¬ 
sage based nature of Windows. BOUNDS-CHECKER V2.0 For 
Windows introduces an event logging and display capability 
that captures all Windows messages, API calls, API returns 
and other events. The information is displayed in a high-level 
overview that lets you see how your program is interacting 
with Windows. When you want to see more detail, simply click 
to see a section expanded in great detail. 

EASY TO USE — Unlike other debugging tools, there's no 
learning curve with BOUNDS-CHECKER. Simply select your 
program's name from BOUNDS-CHECKER's menu; all the rest 
is automatic. There is nothing to link-in and no macros to 
compile into your program. All this plus the functionality of a 
heap checker, super spy utility, debug kernel, API debugger, 
and a post mortem tool into a single comprehensive auto¬ 
matic bug finder. 


BOUNDS-CHECKER Trapping a Parameter Validation Error 


Call now for overnight delivery. 

BOUNDS-CHECKER V2.0 For Windows... Only $249 
BOUNDS-CHECKER For MS DOS... $199 
Order both versions & SAVE $150... Only $298 


Whether you're the boss, the QA Manager or the programmer, it's your responsibility to ensure that 
your company's Windows programs are "bug-free" before they get into the hands of customers. 
If you're developing under C or C++, producing a "bug-free" Windows product is no longer a long 
and stressful experience. 


File Action Settings Window Help 


Procedure: 

Hodule: 


Nu-Mega Technologies Demo 




BCHKW-DEM03.EXE 


if (iPraae == 8) 

pPal->palVersion * 0; 
hPal = Crea+ePalette <pPal>; 


anDisplayEraae (001S8H) 
bitmap.obj (bitmap.c line 


* Parameter Validation Error * 


ANIMATE3 R^ers Info 
D group (sag 2) 


For even greater debugging power get the 
Nu-Mega Power Pack! The Power Pack 
combines BOUNDS-CHECKER and Soft-ICE 
for Dos and Windows all bundled at great 
savings that put you in total control of both 
environments. And to make things even 
better you save over $400 and it comes in 
the great carrying case shown here. 

Call Today 


BOUNDS CHECKER, SOFT-ICE, AND NU-MEGA TECHNOLOGIES are trademarks owned by Nu-Mega Technologies, Inc. All other trademarks are owned by their respective owners. 


Call (603) 889-2386 
fax (603) 889-1135 

If 

?N 

u-Mesa 

RISK = NULL 

30 DAY 

MONEY-BACK GUARANTEE 

P.O. Box 7780 

Nashua, NH 03060-7780 U.S.A. 

Technologies inc 

24 HOUR BBS 
603-595-0386 
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